PHPackages                             edzeery/mystatuskit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. edzeery/mystatuskit

ActiveLibrary

edzeery/mystatuskit
===================

مكتبة موحّدة لإدارة ألوان وأيقونات الحالات (Status Colors & Icons) في مشاريع Laravel، بدون اعتماد على Filament أو أي حزمة UI خارجية.

1.2.2(1mo ago)036↓66.7%MITJavaScriptPHP ^8.1CI failing

Since Jul 13Pushed 1mo agoCompare

[ Source](https://github.com/Edzeery/mystatuskit)[ Packagist](https://packagist.org/packages/edzeery/mystatuskit)[ RSS](/packages/edzeery-mystatuskit/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (10)Versions (17)Used By (0)

MyStatusKit — Laravel Status Kit
================================

[](#mystatuskit--laravel-status-kit)

### (`edzeery/mystatuskit`)

[](#edzeerymystatuskit)

[![Latest Version on Packagist](https://camo.githubusercontent.com/0c4d36da9256c74923163fb78e860f95fdc822538ff25d0f3645fbaef58aa0b9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65647a656572792f6d797374617475736b69742e737667)](https://packagist.org/packages/edzeery/mystatuskit)[![Total Downloads](https://camo.githubusercontent.com/c8e8b7aeaae0977b03ab2dd2a66f3eb83197e5180516122835b682d1265dba4a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65647a656572792f6d797374617475736b69742e737667)](https://packagist.org/packages/edzeery/mystatuskit)[![License](https://camo.githubusercontent.com/1e57a5fdf7129b2e60aa2140b447da3ee38ab41985c4a1e11bf4f0e902dc6482/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f65647a656572792f6d797374617475736b69742e737667)](https://github.com/Edzeery/mystatuskit/blob/main/LICENSE)[![Tests](https://github.com/Edzeery/mystatuskit/actions/workflows/tests.yml/badge.svg)](https://github.com/Edzeery/mystatuskit/actions)

مكتبة موحّدة لإدارة **ألوان وأيقونات وقوائم الحالات** (Status Colors, Icons, Badges & Select) في أي مشروع Laravel — **بدون أي اعتماد على Filament أو أي حزمة UI خارجية**.

- **280+ حالة جاهزة** عبر 10 نطاقات (domains): `payment`, `subscription`, `user`, `stores`, `order`, `product`, `role`, `invoice`, `notification`, `general`
- **5 مجموعات أيقونات**: FontAwesome, Bootstrap Icons, Ionicons, Heroicons (SVG مضمّن), SVG مخصص
- **فريمووركان للألوان**: Bootstrap 5 و Tailwind CSS — مع سهولة التبديل
- **Blade Components**: ``, ``, ``, `` (Alpine.js), ``, `` (Livewire)
- **متوافق مع**: PHP 8.1+ / Laravel 10, 11, 12, 13
- **Livewire 3**: `` و `` يدعمان `wire:model` و `wire:model.live`

---

المحتويات
---------

[](#المحتويات)

- [1. التثبيت](#1-%D8%A7%D9%84%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA)
- [2. تثبيت مكتبات الأيقونات](#2-%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%85%D9%83%D8%AA%D8%A8%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D9%8A%D9%82%D9%88%D9%86%D8%A7%D8%AA)
- [3. اختيار فريموورك الألوان](#3-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1-%D9%81%D8%B1%D9%8A%D9%85%D9%88%D9%88%D8%B1%D9%83-%D8%A7%D9%84%D8%A3%D9%84%D9%88%D8%A7%D9%86)
- [4. الاستعمال](#4-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D9%85%D8%A7%D9%84)
- [5. إضافة نطاق أو حالة جديدة](#5-%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-%D9%86%D8%B7%D8%A7%D9%82-%D8%A3%D9%88-%D8%AD%D8%A7%D9%84%D8%A9-%D8%AC%D8%AF%D9%8A%D8%AF%D8%A9)
- [6. جدول الترحيل](#6-%D8%AC%D8%AF%D9%88%D9%84-%D8%A7%D9%84%D8%AA%D8%B1%D8%AD%D9%8A%D9%84)
- [7. البنية الداخلية](#7-%D8%A7%D9%84%D8%A8%D9%86%D9%8A%D8%A9-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84%D9%8A%D8%A9)
- [8. الاختبارات](#8-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1%D8%A7%D8%AA)
- [9. استكشاف الأخطاء](#9-%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1)
- [10. الإصدارات](#10-%D8%A7%D9%84%D8%A5%D8%B5%D8%AF%D8%A7%D8%B1%D8%A7%D8%AA)
- [11. المتطلبات](#11-%D8%A7%D9%84%D9%85%D8%AA%D8%B7%D9%84%D8%A8%D8%A7%D8%AA)
- [12. الترخيص](#12-%D8%A7%D9%84%D8%AA%D8%B1%D8%AE%D9%8A%D8%B5)

---

1. التثبيت
----------

[](#1-التثبيت)

### الطريقة الموصى بها — Packagist

[](#الطريقة-الموصى-بها--packagist)

```
composer require edzeery/mystatuskit
```

هذا كافٍ في أي مشروع Laravel — الحزمة تُسجَّل تلقائياً (Auto-Discovery) بدون أي إعداد يدوي.

> **ملاحظة:** إذا أردت تقييد نسخة معينة:
>
> ```
> composer require edzeery/mystatuskit:^1.2
> ```

### البديل: مستودع VCS من GitHub

[](#البديل-مستودع-vcs-من-github)

مفيد إذا أردت commit معيّن قبل أن يصل Packagist:

```
{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/Edzeery/mystatuskit"
        }
    ],
    "require": {
        "edzeery/mystatuskit": "^1.2"
    }
}
```

ثم:

```
composer update edzeery/mystatuskit
```

### للتطوير المحلي

[](#للتطوير-المحلي)

```
"repositories": [
    { "type": "path", "url": "../mystatuskit" }
]
```

### نشر الملفات القابلة للتخصيص (اختياري لكن مُستحسن)

[](#نشر-الملفات-القابلة-للتخصيص-اختياري-لكن-مُستحسن)

```
php artisan vendor:publish --tag=status-kit-config   # config/icons.php + config/statuses.php + config/theme.php
php artisan vendor:publish --tag=status-kit-lang      # lang/vendor/status-kit/{ar,en,fr}
php artisan vendor:publish --tag=status-kit-views     # قوالب البادج والـ Select
php artisan vendor:publish --tag=status-kit-svg       # ملفات heroicons SVG
```

> **تحذير:** بعد كل `composer update` للحزمة، إذا كنت ناشر `status-kit-views` من قبل، أعد نشرها مع `--force`:
>
> ```
> php artisan vendor:publish --tag=status-kit-views --force
> php artisan view:clear
> ```

---

2. تثبيت مكتبات الأيقونات
-------------------------

[](#2-تثبيت-مكتبات-الأيقونات)

هذه المكتبات هي أصول Frontend (CSS/JS) وليست حزم Composer:

### الطريقة الأسرع: CDN من الحزمة مباشرة

[](#الطريقة-الأسرع-cdn-من-الحزمة-مباشرة)

في `` من layout الرئيسي:

```
@statusKitAssets(['fa', 'bi', 'ion'])
```

أو من PHP:

```
{!! status_kit_assets(['fa', 'ion']) !!}
```

يُدرج روابط CDN من `config/icons.php['cdn']`. **مناسب للتطوير**، لكن يعتمد على اتصال خارجي.

### الطريقة الموصى بها للإنتاج: تثبيت محلي عبر NPM

[](#الطريقة-الموصى-بها-للإنتاج-تثبيت-محلي-عبر-npm)

```
npm install @fortawesome/fontawesome-free bootstrap-icons ionicons
```

في `resources/css/app.css`:

```
@import '@fortawesome/fontawesome-free/css/all.min.css';
@import 'bootstrap-icons/font/bootstrap-icons.css';
```

في `resources/js/app.js` (اختياري لـ Ionicons):

```
import 'ionicons/dist/ionicons.js';
```

ثم `npm run build`.

### الطريقة اليدوية

[](#الطريقة-اليدوية)

حمّل الملفات من المصادر الرسمية وضعها في `public/vendor/`:

- FontAwesome:
- Bootstrap Icons:
- Ionicons:

### ملاحظة Heroicons

[](#ملاحظة-heroicons)

لا تحتاج أي تثبيت — ملفات SVG مضمّنة داخل الحزمة (`resources/svg/heroicons`). تُعرض مباشرة بدون أي خط خارجي.

---

3. اختيار فريموورك الألوان
--------------------------

[](#3-اختيار-فريموورك-الألوان)

الحزمة تدعم فريمووركين، الافتراضي **Bootstrap 5**:

```
php artisan vendor:publish --tag=status-kit-config
```

في `config/status-kit-theme.php`:

```
'default_framework' => 'bootstrap', // أو 'tailwind'
```

يمكن تجاوز الافتراضي لكل استدعاء:

```
Status::for('payment', 'paid')->color(framework: 'tailwind');
Status::for('payment', 'paid')->badge(framework: 'bootstrap');
```

الفريمووركالكلاسات المستعملة**Bootstrap 5** (الافتراضي)`text-bg-success`, `text-bg-danger`... (جاهزة من Bootstrap 5.1+)**Tailwind CSS**كلاسات `light`/`dark` اليدوية المعرّفة مع كل حالة في `config/statuses.php`---

4. الاستعمال
------------

[](#4-الاستعمال)

### 4.1 Facade — الواجهة الرئيسية

[](#41-facade--الواجهة-الرئيسية)

```
use Edzeery\MyStatusKit\Facades\Status;

// جلب بيانات الحالة
Status::for('payment', 'paid')->color();       // "text-bg-success" (Bootstrap) أو كلاسات Tailwind
Status::for('payment', 'paid')->hex();          // "#16a34a"
Status::for('payment', 'paid')->variant();      // "success"
Status::for('payment', 'paid')->label();        // "مدفوع" (مترجم حسب اللغة)
Status::for('payment', 'paid')->label('en');    // "Paid" (فرض لغة)
Status::for('payment', 'paid')->icon('fa');     //
Status::for('payment', 'paid')->badge('bi');    // HTML بادج كامل جاهز
Status::for('payment', 'paid')->toArray();      // ['domain' => ..., 'status' => ..., ...]

// جلب كل حالات نطاق معين
Status::domain('payment');  // ['paid' => StatusResult, 'pending' => StatusResult, ...]

// التحقق من وجود حالة
Status::exists('payment', 'paid');      // true
Status::exists('payment', 'nonexistent'); // false

// جلب كل النطاقات
Status::domains(); // ['payment', 'subscription', 'user', ...]

// تسجيل حالات جديدة أثناء التشغيل
Status::register('custom', 'new_status', [
    'variant' => 'info', 'hex' => '#2563eb', 'icon' => 'info',
]);
Status::registerMany('custom', ['s1' => [...], 's2' => [...]]);

// التحقق من الحالة الحالية
$result = Status::for('payment', 'paid');
$result->is('paid');                            // true
$result->isOneOf(['paid', 'completed']);         // true
$result->inDomain('payment');                    // true
echo $result;                                    // "مدفوع" (Stringable)
json_encode($result);                            // {"domain":"payment","status":"paid",...} (JsonSerializable)
```

### 4.2 Helpers (متوافقة مع المكتبة القديمة)

[](#42-helpers-متوافقة-مع-المكتبة-القديمة)

```
status_color('payment', 'paid');               // "text-bg-success"
status_hex('payment', 'paid');                 // "#16a34a"
status_label('payment', 'paid');               // "مدفوع"
status_label('payment', 'paid', 'fr');         // "Payé"
status_icon('payment', 'paid', 'bi');          //
status_badge('payment', 'paid');               // HTML بادج كامل

icon('paid', 'fa', 'text-lg');                 // أيقونة فقط
svg_icon('custom-logo', 'w-6 h-6');            // SVG من resources/svg
getIconHtml('paid');                            // متوافقة مع النسخة القديمة (deprecated)
status_kit_assets(['fa', 'ion']);               // إدراج CDN
status_exists('payment', 'paid');               // true
status_domain('payment');                       // ['paid' => StatusResult, ...]
status_domains();                               // ['payment', 'subscription', ...]
status('payment', 'paid');                      // كائن StatusResult كامل
```

### 4.3 Blade Component — البادج

[](#43-blade-component--البادج)

```

```

**Props:**

Propالنوعالافتراضيالوصف`domain`string**إجباري**نطاق الحالة (payment, user, general...)`status`string**إجباري**اسم الحالة (paid, active, banned...)`set`stringnullمجموعة الأيقونات (fa/bi/ion/heroicon/svg)`icon`booltrueإظهار/إخفاء الأيقونة`class`string''كلاسات CSS إضافية### 4.4 Blade Component — النقطة اللونية (Dot)

[](#44-blade-component--النقطة-اللونية-dot)

نقطة لونية صغيرة بدون نص، مناسبة للقوائم والجداول:

```

```

**Props:**

Propالنوعالافتراضيالوصف`domain`string**إجباري**نطاق الحالة`status`string**إجباري**اسم الحالة`size`string'md'الحجم: `sm` / `md` / `lg``class`string''كلاسات CSS إضافية### 4.5 Blade Component — الأيقونة فقط (Icon)

[](#45-blade-component--الأيقونة-فقط-icon)

```

```

### 4.6 Blade Component — شريط التقدم (Progress)

[](#46-blade-component--شريط-التقدم-progress)

شريط تقدم ملوّن يعرض نسبة مئوية مع دعم ARIA:

```

```

**Props:**

Propالنوعالافتراضيالوصف`domain`string**إجباري**نطاق الحالة`status`string**إجباري**اسم الحالة`value`int100النسبة المئوية (0-100)`size`string'md'الحجم: `sm` / `md` / `lg``showLabel`booltrueإظهار `sr-only` label`class`string''كلاسات CSS إضافية### 4.7 Blade Component — البادج Livewire (Badge Wire)

[](#47-blade-component--البادج-livewire-badge-wire)

بادجLivewire متوافق مع `wire:model` و `wire:model.live`:

```
{{-- استعمال عادي --}}

{{-- مع قيمة ديناميكية من Livewire --}}

```

### 4.9 Blade Component — القائمة المخصصة (Select)

[](#49-blade-component--القائمة-المخصصة-select)

`` — قائمة اختيار مخصصة مبنية بـ **Alpine.js**، تعرض أيقونة + نقطة لون + تسمية لكل حالة.

```
{{-- استعمال بسيط --}}

{{-- مع Livewire 3 wire:model --}}

{{-- مع بحث (مفيد للدومينات الكبيرة مثل general) --}}

{{-- تحكم إضافي --}}

```

**Props:**

Propالنوعالافتراضيالوصف`domain`string**إجباري**نطاق الحالات`name`stringnullاسم حقل الإدخال المخفي (للنماذج)`selected`stringnullالقيمة المحددة مسبقاً`set`stringnullمجموعة الأيقونات`placeholder`stringتلقائي حسب اللغةنص بديل`disabled`boolfalseتعطيل القائمة`searchable`boolfalseتفعيل حقل البحث`size`string'md'الحجم: `sm` / `md` / `lg``class`string''كلاسات CSS إضافية**متطلبات:**

- **Alpine.js** (متوفر تلقائيًا مع Livewire 3)
- **Bootstrap Icons** للسهم وعلامة الاختيار (`bi bi-chevron-down`, `bi bi-check-lg`) — ثابتة بغض النظر عن `set`

**إعدادات قابلة للتخصيص** عبر `config/status-kit-theme.php`:

```
'select' => [
    'max_height'  => '16rem',  // ارتفاع أقصى للائحة
    'z_index'     => 50,       // z-index لوحة الاختيار
    'default_set' => null,     // null = يتبع status-kit-icons.default_set
],
```

### 4.10 الأدوار

[](#410-الأدوار)

```
Status::for('role', 'super_admin')->badge('heroicon');
Status::for('role', 'admin')->badge('fa');
```

### 4.11 Eloquent Cast — StatusCast

[](#411-eloquent-cast--statuscast)

تحويل قاعدة البيانات تلقائيًا إلى كائن `StatusResult`:

```
use Edzeery\MyStatusKit\Casts\StatusCast;

class Order extends Model
{
    protected $casts = [
        'status' => StatusCast::class . ':payment',
    ];
}

// الاستعمال:
$order = Order::find(1);
$order->status->label();   // "مدفوع"
$order->status->hex();     // "#16a34a"
echo $order->status;       // "مدفوع" (Stringable)
```

**ملاحظة:** النطاق (`domain`) يُمرر كمعامل إضافي بعد dấu `:` في تعريف الـ Cast.

### 4.12 Blade Directives

[](#412-blade-directives)

```
{{-- تكرار حالات نطاق معين --}}
@statusFor('payment')
    {{ $key }}: {{ $statusResult->label() }}
@endstatusFor

{{-- عرض إحصائيات النطاق --}}
@statusLegend('payment')
    @foreach($__statusLegendItems as $key => $result)
        {{ $result->label() }}
    @endforeach
@endStatusLegend
```

---

5. إضافة نطاق أو حالة جديدة
---------------------------

[](#5-إضافة-نطاق-أو-حالة-جديدة)

### الخطوة 1: تعريف الحالة في config

[](#الخطوة-1-تعريف-الحالة-في-config)

بعد نشر `config/statuses.php`:

```
// config/statuses.php
'invoice' => [
    'draft' => [
        'variant' => 'info',
        'light'   => 'text-blue-700 bg-blue-100',
        'dark'    => 'dark:text-blue-300 dark:bg-blue-900/40',
        'hex'     => '#2563eb',
        'icon'    => 'draft',
    ],
],
```

### الخطوة 2: إضافة الترجمات

[](#الخطوة-2-إضافة-الترجمات)

في كل ملف لغة (`lang/vendor/status-kit/{ar,en,fr}/statuses.php`):

```
// lang/vendor/status-kit/ar/statuses.php
'invoice' => ['draft' => 'مسودة'],

// lang/vendor/status-kit/en/statuses.php
'invoice' => ['draft' => 'Draft'],

// lang/vendor/status-kit/fr/statuses.php
'invoice' => ['draft' => 'Brouillon'],
```

> **مهم:** تأكد أن المفتاح موجود بالضبط في الثلاث ملفات — بلا نقص وبلا تكرار.

### الخطوة 3: إضافة الأيقونة (اختياري)

[](#الخطوة-3-إضافة-الأيقونة-اختياري)

في `config/icons.php`، أضف المفتاح لكل مجموعة:

```
'fa'    => ['draft' => 'fa-file'],
'bi'    => ['draft' => 'bi-file-earmark'],
'ion'   => ['draft' => 'document-outline'],
```

### الاستعمال:

[](#الاستعمال)

```
Status::for('invoice', 'draft')->badge('fa');
// أو
status_badge('invoice', 'draft', 'bi');
```

---

6. جدول الترحيل من الملفات القديمة
----------------------------------

[](#6-جدول-الترحيل-من-الملفات-القديمة)

الطريقة القديمةالطريقة الجديدة`config('payment-colors.payment.paid')``Status::for('payment', 'paid')->color()``config('subscription-colors.subscription.active')``Status::for('subscription', 'active')->color()``config('status-colors.order.pending')``Status::for('order', 'pending')->color()``config('roles.admin')``Status::for('role', 'admin')``icon('paid', 'fa')``icon('paid', 'fa')` (بدون تغيير)`getIconHtml(...)``getIconHtml(...)` (بدون تغيير)مفتاح `filament`أصبح `variant` (نفس المعنى)أيقونات `heroicon-o-*`مفاتيح عامة تُترجم حسب `$set` وقت العرض---

7. البنية الداخلية
------------------

[](#7-البنية-الداخلية)

```
src/
├── StatusKitServiceProvider.php   # التسجيل والتحميل
├── StatusManager.php              # قراءة config وبناء StatusResult
├── IconManager.php                # منطق عرض الأيقونات (fa/bi/ion/heroicon/svg)
├── DTO/
│   └── StatusResult.php           # DTO بواجهة fluent + Stringable + JsonSerializable
├── Casts/
│   └── StatusCast.php             # Eloquent Cast لتحويل DB إلى StatusResult
├── Facades/
│   ├── Status.php                 # Facade للStatusManager
│   └── Icon.php                   # Facade للIconManager
├── Support/
│   └── AssetsRenderer.php         # إدراج CDN مع دعم SRI
└── Helpers/
    └── helpers.php                # دوال مساعدة (status_color, status_exists, ...)

resources/views/components/
├── status-badge.blade.php         # البادج (ARIA: role="status")
├── status-badge-wire.blade.php    # البادج Livewire (wire:ignore.self)
├── status-dot.blade.php           # النقطة اللونية (sm/md/lg)
├── status-icon.blade.php          # الأيقونة فقط (ARIA: role="img")
├── status-progress.blade.php      # شريط التقدم (ARIA: progressbar)
└── status-select.blade.php        # القائمة المخصصة (Alpine.js)

resources/svg/heroicons/           # ملفات SVG مضمّنة (Heroicons)

config/
├── statuses.php                   # تعريف الحالات (ألوان + hex + أيقونة + variant + _shared)
├── icons.php                      # mapping المفاتيح لأسماء الأيقونات لكل مجموعة (مع SRI hashes)
└── theme.php                      # إعدادات الفريموورك + heroicon_dir + svg_cache + fallback_locale

lang/{ar,en,fr}/statuses.php      # الترجمات

```

---

8. الاختبارات
-------------

[](#8-الاختبارات)

الحزمة تتضمن اختبارات PHPUnit شاملة:

```
# تشغيل كل الاختبارات
composer test

# تشغيل اختبارات معيّنة
vendor/bin/phpunit --filter StatusManagerTest
vendor/bin/phpunit --filter StatusResultTest
vendor/bin/phpunit --filter IconManagerTest
vendor/bin/phpunit --filter HelpersTest
vendor/bin/phpunit --filter ServiceProviderTest
vendor/bin/phpunit --filter AssetsRendererTest
vendor/bin/phpunit --filter AdvancedTest
```

**جودة الكود:**

```
# فحص PHPStan (Static Analysis)
composer analyse

# تنسيق الكود عبر Pint
composer format
```

---

9. استكشاف الأخطاء
------------------

[](#9-استكشاف-الأخطاء)

### `Unable to locate a class or view for component [status-select]`

[](#unable-to-locate-a-class-or-view-for-component-status-select)

**السبب:** نشرت `status-kit-views` من نسخة قديمة.

**الحل:**

```
php artisan vendor:publish --tag=status-kit-views --force
php artisan view:clear
```

إذا استمر:

```
php artisan optimize:clear
composer dump-autoload
```

### الترجمة ترجع بالإنجليزي بدلاً من النص الصحيح

[](#الترجمة-ترجع-بالإنجليزي-بدلاً-من-النص-الصحيح)

**السبب:** عدم تطابق المفتاح بين `config/statuses.php` و `lang/{locale}/statuses.php`.

**الحل:**

1. تأكد أن المفتاح موجود في كل ملفات اللغة الثلاث
2. نفّذ:

```
php artisan config:clear
```

### الألوان ما تبانش

[](#الألوان-ما-تبانش)

**السبب:** `config/status-kit-theme.php['default_framework']` لا يطابق CSS framework الفعلي.

**الحل:** عدّل الإعداد ليتطابق مع مشروعك (`bootstrap` أو `tailwind`).

### `` لا يعمل مع Tailwind

[](#x-status-select-لا-يعمل-مع-tailwind)

**السبب:** تأكد أن `config/status-kit-theme.php['default_framework']` = `'tailwind'`.

**ملاحظة:** القائمة المخصصة تحتاج **Bootstrap Icons** للسهم وعلامة الاختيار (`bi bi-chevron-down`, `bi bi-check-lg`) — حتى مع Tailwind للألوان.

---

10. الإصدارات
-------------

[](#10-الإصدارات)

\###\_rules

1. عدّل الكود وادفعه لفرع `main`
2. من GitHub: `Releases → Draft a new release`
3. أنشئ Tag يتبع [Semantic Versioning](https://semver.org):
    - **Bug fix** → `v1.1.x`
    - **ميزة جديدة متوافقة** → `v1.x.0`
    - **breaking change** → `v2.0.0`
4. Packagist يتحدث تلقائياً عبر GitHub webhook

**آخر إصدار: v1.2.0**

---

11. المتطلبات
-------------

[](#11-المتطلبات)

المتطلبالإصدارPHP`^8.1`Laravel`^10Alpine.jsفقط إذا استعملت ``Bootstrap 5.1+الافتراضي للألوانLivewire 3اختياري — لـ `wire:model` في ``---

12. الترخيص
-----------

[](#12-الترخيص)

MIT License — مفتوح المصدر بالكامل.

---

المساهمة
--------

[](#المساهمة)

مرحباً بك في المساهمة! يرجى فتح Issue أو Pull Request على GitHub:

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance93

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

16

Last Release

36d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/87f355210e35ba1aa9c18a338b9db43a2bd962db3d04f2b85945fe26d4f8b5c1?d=identicon)[edzeery](/maintainers/edzeery)

---

Top Contributors

[![Edzeery](https://avatars.githubusercontent.com/u/82891318?v=4)](https://github.com/Edzeery "Edzeery (37 commits)")

---

Tags

laraveliconsHeroiconsstatusbadgeioniconsFontAwesomecolorsBootstrap Icons

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/edzeery-mystatuskit/health.svg)

```
[![Health](https://phpackages.com/badges/edzeery-mystatuskit/health.svg)](https://phpackages.com/packages/edzeery-mystatuskit)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.1k6.4M360](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3365.5M359](/packages/psalm-plugin-laravel)[technikermathe/blade-lucide-icons

A package to easily make use of Lucide icons in your Laravel Blade views.

18533.4k13](/packages/technikermathe-blade-lucide-icons)[erag/laravel-lang-sync-inertia

A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications.

6036.2k](/packages/erag-laravel-lang-sync-inertia)[api-platform/laravel

API Platform support for Laravel

58190.1k22](/packages/api-platform-laravel)[ublabs/blade-simple-icons

A package to easily make use of Simple Icons in your Laravel Blade views.

1868.9k](/packages/ublabs-blade-simple-icons)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)