{"id":21069175,"url":"https://github.com/devfaysal/laravel-admin","last_synced_at":"2025-05-16T04:34:21.118Z","repository":{"id":56966550,"uuid":"222055421","full_name":"devfaysal/laravel-admin","owner":"devfaysal","description":"Roles/Permission UI for Laravel Application","archived":false,"fork":false,"pushed_at":"2024-06-20T04:29:22.000Z","size":3370,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-10T13:51:57.407Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devfaysal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-16T06:08:07.000Z","updated_at":"2024-06-20T04:29:25.000Z","dependencies_parsed_at":"2024-06-20T16:04:05.310Z","dependency_job_id":"e1136978-110f-49d4-8c46-10a6e61945d3","html_url":"https://github.com/devfaysal/laravel-admin","commit_stats":{"total_commits":111,"total_committers":2,"mean_commits":55.5,"dds":"0.12612612612612617","last_synced_commit":"a0ad78e912d4d2813fbaf7d05f097d4a64e6c6f1"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfaysal%2Flaravel-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfaysal%2Flaravel-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfaysal%2Flaravel-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devfaysal%2Flaravel-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devfaysal","download_url":"https://codeload.github.com/devfaysal/laravel-admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254470303,"owners_count":22076566,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T18:33:00.688Z","updated_at":"2025-05-16T04:34:16.110Z","avatar_url":"https://github.com/devfaysal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Roles/Permission UI for Laravel Application\n\n![Screenshot_2019-12-20 Laravel](https://user-images.githubusercontent.com/16212149/73057065-c3eab700-3eba-11ea-802a-1f564d3af4ad.png)\n\n### Following packages/Libraries used\n- [Laravel Permission by Spatie](https://github.com/spatie/laravel-permission)\n- [Modular Admin Html](https://github.com/modularcode/modular-admin-html)\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/devfaysal/laravel-admin.svg?style=flat-square)](https://packagist.org/packages/devfaysal/laravel-admin)\n[![Build Status](https://img.shields.io/travis/devfaysal/laravel-admin/master.svg?style=flat-square)](https://travis-ci.org/devfaysal/laravel-admin)\n[![Quality Score](https://img.shields.io/scrutinizer/g/devfaysal/laravel-admin.svg?style=flat-square)](https://scrutinizer-ci.com/g/devfaysal/laravel-admin)\n[![Total Downloads](https://img.shields.io/packagist/dt/devfaysal/laravel-admin.svg?style=flat-square)](https://packagist.org/packages/devfaysal/laravel-admin)\n\nThis is where your description should go. Try and limit it to a paragraph or two, and maybe throw in a mention of what PSRs you support to avoid any confusion with users and contributors.\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require devfaysal/laravel-admin\n```\n\nThen add the following middleware to the ``` $routeMiddleware ``` array in ``` app/Http/kernel.php ```\n```php\n'admin.auth' =\u003e \\Devfaysal\\LaravelAdmin\\Http\\Middleware\\AdminAuthenticate::class,\n'admin.guest' =\u003e \\Devfaysal\\LaravelAdmin\\Http\\Middleware\\AdminRedirectIfAuthenticated::class,\n'role' =\u003e \\Spatie\\Permission\\Middlewares\\RoleMiddleware::class,\n'permission' =\u003e \\Spatie\\Permission\\Middlewares\\PermissionMiddleware::class,\n'role_or_permission' =\u003e \\Spatie\\Permission\\Middlewares\\RoleOrPermissionMiddleware::class,\n```\n\nPublish Assets\n```bash\nphp artisan vendor:publish --tag=laravel-admin-public\n```\n\nPublish Seeds\n```bash\nphp artisan vendor:publish --tag=laravel-admin-seeders\n```\n\nRun Migration\n```bash\nphp artisan migrate\n```\nRun seeder\n```bash\ncomposer dump-autoload\n\nphp artisan db:seed --class=LaravelAdminSeeder\n```\n\n## Usage\n\n``` php\nphp artisan serve\n```\nThen visit localhost:8000/admin/login\n\nusername: hello@faysal.me\npassword: password\n\nAdditionally if you want to customize the blade view files and want to add other options and menu in the admin panel, you can publish the views and extend\n\n```php\nphp artisan vendor:publish --tag=laravel-admin-views\n```\nIf you want to add menu items in the sidebar menu, you need to create a file named ```menus.blade.php``` in your root view directoray.\nIt will automatically register menus in the sidebar.\n\nFor javascript and css, ```javascript.blade.php``` and ```styles.blade.php```\n\n### Dashboard modification\nTo update Dashboard, register ```/admin/dashboard``` route and use your own controller and view.\nIf you want the current html design, check vendor folder and copy dashboard.blade.php file from ```resource/views``` folder inside the package.\n\n#### Blade components\nAdd a stats section component:\n``` php\n\u003cx-laravel-admin::stats-section title=\"Another title\"\u003e\n    \u003cx-laravel-admin::stats-item count=\"50\" label=\"Lorem\" icon=\"fa fa-user\"/\u003e\n    \u003cx-laravel-admin::stats-item count=\"50\" label=\"Lorem\"/\u003e\n    \u003cx-laravel-admin::stats-item count=\"50\" label=\"Lorem\"/\u003e\n    \u003cx-laravel-admin::stats-item/\u003e\n\u003c/x-laravel-admin::stats-section\u003e\n```\n![stats-section](https://user-images.githubusercontent.com/16212149/95416732-23a7c600-0955-11eb-9de8-6393fe1596e0.png)\n\nForm field components\n``` php\n\u003cx-text-field name=\"text\" value=\"Some Value\" label=\"Text Field\" tooltip=\"Tooltip\" placeholder=\"lorem\"/\u003e\n\u003cx-textarea-field name=\"textarea\" value=\"Some Text\" label=\"Textarea Field\"/\u003e\n\u003cx-select-field name=\"select\" :data=\"[1,2,3,4,5]\" label=\"Select Field\"/\u003e\n\u003cx-password-field name=\"password\" label=\"Password Field\"/\u003e\n\u003cx-number-field name=\"number\" value=\"5\" label=\"Number Field\" min=\"0\"/\u003e\n\u003cx-hidden-field name=\"hidden\"/\u003e\n\u003cx-file-field name=\"file\" label=\"File Field\"/\u003e\n\u003cx-email-field name=\"email\" value=\"email@example.com\" label=\"Email Field\"/\u003e\n\u003cx-date-field name=\"date\" value=\"2020-12-12\" label=\"Date Field\"/\u003e\n\u003cx-checkbox-field name=\"checkbox\" label=\"Checkbox Field\" value=\"1\"/\u003e\n```\n\n### Testing\n\n``` bash\ncomposer test\n```\n\n### Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n### Security\n\nIf you discover any security related issues, please email hello@faysal.me instead of using the issue tracker.\n\n## Credits\n\n- [Faysal Ahamed](https://github.com/devfaysal)\n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevfaysal%2Flaravel-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevfaysal%2Flaravel-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevfaysal%2Flaravel-admin/lists"}