PHPackages ianlabicani/laravel-blade-starter - 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. [Framework](/categories/framework) 4. / 5. ianlabicani/laravel-blade-starter ActiveProject[Framework](/categories/framework) ianlabicani/laravel-blade-starter ================================= A Laravel Breeze starter template with RBAC-ready structure, role-based dashboards, and authentication scaffolding for quick project setup. 1.0.2(4mo ago)03MITBladePHP ^8.2 Since Dec 23Pushed 4mo agoCompare [ Source](https://github.com/ianlabicani/laravel-blade-starter)[ Packagist](https://packagist.org/packages/ianlabicani/laravel-blade-starter)[ RSS](/packages/ianlabicani-laravel-blade-starter/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (12)Versions (4)Used By (0) Laravel Blade Starter Template ============================== [](#laravel-blade-starter-template) A clean and minimal Laravel starter template with **Laravel Breeze** authentication and **RBAC-ready structure** for building role-based applications quickly. Perfect for projects that need user authentication, role management, and separate dashboards right out of the box. Features -------- [](#features) - โœจ **Laravel 12** - Latest Laravel framework - ๐Ÿ” **Laravel Breeze** - Simple authentication scaffolding - ๐Ÿ‘ฅ **RBAC Structure** - Role-based access control ready - ๐ŸŽจ **Tailwind CSS** - Modern utility-first CSS framework - ๐Ÿš€ **Role-Based Dashboards** - Separate dashboards for Super Admin, Admin, and users - ๐Ÿ“ฑ **Responsive Design** - Mobile-friendly layouts - ๐ŸŽฏ **Font Awesome Icons** - Beautiful icons throughout - ๐ŸŽญ **No-Role Page** - Dedicated page for users without assigned roles - ๐Ÿงช **Pest Testing** - Modern PHP testing framework Requirements ------------ [](#requirements) - PHP >= 8.2 - Composer - Node.js & NPM - MySQL or any supported database Installation ------------ [](#installation) ### Creating a New Project from This Template [](#creating-a-new-project-from-this-template) You can create a new project using Composer's `create-project` command: ``` composer create-project ianlabicani/laravel-blade-starter your-project-name ``` ### Manual Installation [](#manual-installation) 1. Clone the repository: ``` git clone https://github.com/ianlabicani/laravel-blade-starter.git your-project-name cd your-project-name ``` 2. Run the setup script: ``` composer run setup ``` This will automatically: - Install PHP dependencies - Copy `.env.example` to `.env` - Generate application key - Run database migrations - Install NPM dependencies - Build frontend assets 3. Configure your `.env` file with your database credentials: ``` DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database_name DB_USERNAME=your_username DB_PASSWORD=your_password ``` 4. Run migrations to create database tables: ``` php artisan migrate ``` 5. (Optional) Seed the database with sample data: ``` php artisan db:seed ``` Available Scripts ----------------- [](#available-scripts) This template includes several useful Composer scripts to streamline your development workflow: ### Setup Script [](#setup-script) ``` composer run setup ``` Sets up the entire project from scratch: - Installs all PHP dependencies - Creates `.env` file from example - Generates application key - Runs database migrations - Installs Node.js dependencies - Builds frontend assets ### Development Script [](#development-script) ``` composer run dev ``` Starts all development services concurrently: - Laravel development server (`php artisan serve`) - Queue worker (`php artisan queue:listen`) - Vite dev server (`npm run dev`) This uses `concurrently` to run all three services in one terminal window with color-coded output. ### Test Script [](#test-script) ``` composer run test ``` Runs the test suite: - Clears configuration cache - Executes all Pest tests Project Structure ----------------- [](#project-structure) ### Authentication Views [](#authentication-views) All authentication views are located in `resources/views/auth/`: - `login.blade.php` - User login - `register.blade.php` - User registration - `forgot-password.blade.php` - Password reset request - `reset-password.blade.php` - Password reset form - `verify-email.blade.php` - Email verification - `confirm-password.blade.php` - Password confirmation ### Layout Templates [](#layout-templates) - `resources/views/public/layout.blade.php` - Public pages layout - `resources/views/admin/layout.blade.php` - Admin dashboard layout - `resources/views/super-admin/layout.blade.php` - Super Admin dashboard layout ### Role-Based Routing [](#role-based-routing) - `routes/web.php` - Public and dashboard routes - `routes/auth.php` - Authentication routes - `routes/admin.php` - Admin-only routes - `routes/super-admin.php` - Super Admin-only routes ### Models [](#models) - `app/Models/User.php` - User model with role relationships - `app/Models/Role.php` - Role model Usage ----- [](#usage) ### Running the Application [](#running-the-application) Start the development server: ``` composer run dev ``` Or manually start services: ``` # Terminal 1: Laravel Server php artisan serve # Terminal 2: Queue Worker php artisan queue:listen # Terminal 3: Vite Dev Server npm run dev ``` Visit `http://localhost:8000` in your browser. ### Role Management [](#role-management) Users can have roles assigned through the `role_user` pivot table. The dashboard automatically redirects users based on their role: - **Super Admin** โ†’ Super Admin Dashboard - **Admin** โ†’ Admin Dashboard - **No Role** โ†’ No-Role Page (informational page) ### Customization [](#customization) 1. **Update branding**: Modify the app name in `resources/views/public/layout.blade.php` 2. **Customize colors**: Edit Tailwind classes throughout the views 3. **Add new roles**: Create migrations and update the Role model 4. **Extend dashboards**: Add new routes and views in respective role folders Testing ------- [](#testing) Run the test suite: ``` composer run test ``` Or use Pest directly: ``` ./vendor/bin/pest ``` AI-Assisted Development ----------------------- [](#ai-assisted-development) This project includes comprehensive AI coding assistance to help you develop faster and more efficiently. ### Copilot Instructions [](#copilot-instructions) Custom GitHub Copilot instructions are provided in `.github/copilot-instructions.md` to ensure AI suggestions follow the project's patterns and best practices. These instructions cover: - Project structure and architecture conventions - RBAC patterns and role management - Controller and view naming conventions - Route organization guidelines - Testing patterns with Pest - Tailwind CSS usage conventions The instructions help AI assistants understand the project context and provide more accurate suggestions aligned with Laravel 12 and this starter's structure. ### Laravel Boost MCP [](#laravel-boost-mcp) For the best development experience, use [Laravel Boost](https://laravel.com/docs/boost) - a Model Context Protocol (MCP) server designed specifically for Laravel applications. Laravel Boost provides: - **Smart Documentation Search** - Version-specific Laravel documentation for your packages - **Artisan Command Integration** - Direct access to Artisan commands - **Tinker Integration** - Execute PHP code and query Eloquent models directly - **Database Querying** - Read from database without writing PHP - **Browser Log Reading** - Debug frontend issues easily - **Absolute URL Generation** - Get correct project URLs automatically #### Installing Laravel Boost [](#installing-laravel-boost) ``` php artisan boost:install ``` Once installed, Laravel Boost integrates with VS Code's GitHub Copilot and other AI assistants to provide context-aware development support. Built With ---------- [](#built-with) - [Laravel 12](https://laravel.com) - PHP Framework - [Laravel Breeze](https://laravel.com/docs/starter-kits#breeze) - Authentication Scaffolding - [Tailwind CSS](https://tailwindcss.com) - CSS Framework - [Font Awesome](https://fontawesome.com) - Icon Library - [Vite](https://vitejs.dev) - Frontend Build Tool - [Pest](https://pestphp.com) - Testing Framework License ------- [](#license) This project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. Credits ------- [](#credits) Created by [Ian Labicani](https://github.com/ianlabicani) ### Health Score 36 โ€” LowBetter than 82% of packages Maintenance76 Regular maintenance activity Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity49 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 ~4 days Total 3 Last Release 131d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8ceed6c10a08a1731dcf1f5de8652382e89519e4131e8432f5fce5df8f912368?d=identicon)[ianlabicani](/maintainers/ianlabicani) --- Top Contributors [![ianlabicani](https://avatars.githubusercontent.com/u/91765472?v=4)](https://github.com/ianlabicani "ianlabicani (10 commits)") --- Tags frameworklaravelAuthenticationrbacbreezerole-based-access-controlstarter-template ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/ianlabicani-laravel-blade-starter/health.svg) ``` [![Health](https://phpackages.com/badges/ianlabicani-laravel-blade-starter/health.svg)](https://phpackages.com/packages/ianlabicani-laravel-blade-starter) ``` ### Alternatives [codewithdennis/larament Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow. 3691.5k](/packages/codewithdennis-larament) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)