PHPackages engoreoo/atomic-starter-kit - 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. [Authentication & Authorization](/categories/authentication) 4. / 5. engoreoo/atomic-starter-kit ActiveLibrary[Authentication & Authorization](/categories/authentication) engoreoo/atomic-starter-kit =========================== A comprehensive Laravel package that provides rapid setup for Authentication, Dynamic Authorization (ACL), and a full-featured Admin Dashboard. v1.0.0(5mo ago)03MITBladePHP ^8.2 Since Dec 4Pushed 5mo agoCompare [ Source](https://github.com/EngOREOO/atomic-starter-kit)[ Packagist](https://packagist.org/packages/engoreoo/atomic-starter-kit)[ Docs](https://github.com/EngOREOO/ultimate-starter-kit)[ RSS](/packages/engoreoo-atomic-starter-kit/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (2)Used By (0) Ultimate Starter Kit ==================== [](#ultimate-starter-kit) A comprehensive Laravel package that provides rapid setup for Authentication, Dynamic Authorization (ACL), and a full-featured Admin Dashboard. **Created by [Ahmed Hany](https://github.com/EngOREOO/)** ✨ Features ---------- [](#-features) - **🚀 One-Command Installation**: Setup your entire admin panel in minutes. - **🔐 Integrated Authentication**: Built-in, fully customizable authentication system (Login, Register, Password Reset) replacing the need for external Breeze installation. - **👥 Dynamic Role & Permission System**: Granular access control with a database-driven permission system. - **🎨 Modern Admin Dashboard**: Sleek, glassmorphism-inspired UI built with Tailwind CSS. - **🔑 Super Admin System**: Dedicated Super Admin role with global access. - **📊 User Management**: Complete user CRUD operations. - **🛡️ Permission Middleware**: Protect routes easily using `ultimate.permission`. - **⚙️ Settings Management**: Built-in settings configuration. - **🔍 Auto-Route Scanning**: Automatically detects routes and generates permissions. --- 📦 Installation -------------- [](#-installation) ### Step 1: Add Repository Configuration [](#step-1-add-repository-configuration) **IMPORTANT:** Since this package is hosted on GitHub, you need to tell Composer where to find it. Add the following to your project's `composer.json` file in the `repositories` array: ``` "repositories": [ { "type": "vcs", "url": "https://github.com/EngOREOO/atomic-starter-kit.git" } ], ``` ### Step 2: Require the Package [](#step-2-require-the-package) Run the following command in your terminal: ``` composer require engoreoo/ultimate-starter-kit ``` ### Step 3: Install & Setup [](#step-3-install--setup) Run the installation command to set up the database, publish assets, and configure the system: ``` php artisan ultimate:install ``` *Follow the interactive prompts to set up your Super Admin account.* ### Step 4: Frontend Development [](#step-4-frontend-development) Install dependencies and start the development server to compile the Tailwind CSS styles: ``` npm install npm run dev ``` --- 🔧 Configuration --------------- [](#-configuration) The package configuration file is located at `config/ultimate.php`. ``` return [ // The role name for the super admin who has all permissions 'super_admin_role' => 'Super Admin', // The URI prefix for all admin routes (e.g., yoursite.com/admin/dashboard) 'route_prefix' => 'admin', // The middleware group to apply to admin routes 'middleware_group' => 'web', // Whether to automatically scan routes for permissions after installation 'scan_on_install' => true, ]; ``` --- 🔐 Authentication & Customization ------------------------------------ [](#-authentication--customization) This package comes with its own authentication controllers and views, giving you full control over the login flow without relying on third-party scaffolding like Laravel Breeze. ### Views [](#views) All authentication views are located in `vendor/ultimate/auth`. To customize them, you can publish the views to your main `resources/views` directory: ``` php artisan vendor:publish --tag=ultimate-views ``` This will copy all package views to `resources/views/vendor/ultimate`. You can then edit files like: - `resources/views/vendor/ultimate/auth/login.blade.php` - `resources/views/vendor/ultimate/layouts/guest.blade.php` (The layout used for auth pages) ### Routes [](#routes) Authentication routes are automatically registered with the prefix defined in your config (default: `/admin`). - Login: `/admin/login` - Register: `/admin/register` - Dashboard: `/admin/dashboard` --- 🛡️ Usage -------- [](#️-usage) ### Protecting Routes [](#protecting-routes) To protect your own routes using the dynamic permission system, use the `ultimate.permission` middleware. The middleware automatically checks if the user has permission to access the route based on the route name (e.g., `admin.posts.create`). ``` Route::middleware(['auth', 'ultimate.permission'])->group(function () { Route::resource('posts', PostController::class); }); ``` ### Route Scanning [](#route-scanning) Whenever you add new routes that you want to be controlled by permissions, run the scan command: ``` php artisan ultimate:scan-routes ``` This will detect new routes and add them to the permissions table in your database. --- 🛠️ Available Commands --------------------- [](#️-available-commands) CommandDescription`php artisan ultimate:install`Installs the package, runs migrations, and creates the Super Admin.`php artisan ultimate:scan-routes`Scans your application routes and syncs them with the permissions table.--- 📋 Troubleshooting ----------------- [](#-troubleshooting) **"Could not find a matching version"** - Ensure you added the `repositories` block to your `composer.json` correctly. - Run `composer clear-cache`. **"GitHub API limit exhausted"** - Use a personal access token with Composer: `composer config --global github-oauth.github.com ` **Styles look broken** - Ensure you are running `npm run dev` or have run `npm run build`. - Verify that `ultimate-starter-kit` views are being scanned by Tailwind (this is handled automatically during install, but check `tailwind.config.js` if issues persist). --- Author ------ [](#author) **Ahmed Hany** - 🌐 **GitHub**: [@EngOREOO](https://github.com/EngOREOO/) - 📧 **Email**: License ------- [](#license) The MIT License (MIT). ### Health Score 34 — LowBetter than 77% of packages Maintenance72 Regular maintenance activity Popularity3 Limited adoption so far Community8 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 84.2% 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 Unknown Total 1 Last Release 166d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a15fa7f6573dd98b3c00d05ab01dff70fb11149e3bda9b133f89a8c3f5d53c04?d=identicon)[EngOREOO](/maintainers/EngOREOO) --- Top Contributors [![prackels](https://avatars.githubusercontent.com/u/113942518?v=4)](https://github.com/prackels "prackels (32 commits)")[![EngOREOO](https://avatars.githubusercontent.com/u/96397011?v=4)](https://github.com/EngOREOO "EngOREOO (6 commits)") --- Tags laravelAuthenticationauthorizationaclrolespermissionsdashboardadminstarter-kitbreeze ### Embed Badge ![Health badge](/badges/engoreoo-atomic-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/engoreoo-atomic-starter-kit/health.svg)](https://phpackages.com/packages/engoreoo-atomic-starter-kit) ``` ### Alternatives [santigarcor/laratrust This package provides a flexible way to add Role-based Permissions to Laravel 2.3k5.4M43](/packages/santigarcor-laratrust)[silvanite/novatoolpermissions Laravel Nova Permissions (Roles and Permission based Access Control (ACL)) 100256.7k2](/packages/silvanite-novatoolpermissions)[pktharindu/nova-permissions Laravel Nova Grouped Permissions (ACL) 136387.1k](/packages/pktharindu-nova-permissions)[hasinhayder/tyro Tyro - The ultimate Authentication, Authorization, and Role & Privilege Management solution for Laravel 12 & 13 6712.1k2](/packages/hasinhayder-tyro)[shanmuga/laravel-entrust This package provides a flexible solution to add ACL to Laravel 68312.9k2](/packages/shanmuga-laravel-entrust)[smarch/watchtower Front-end for the Shinboi Auth system of Users / Roles / Permissions in Laravel 5 523.0k](/packages/smarch-watchtower) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)