PHPackages shopperlabs/laravel-sail-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. [Framework](/categories/framework) 4. / 5. shopperlabs/laravel-sail-starter-kit ActiveProject[Framework](/categories/framework) shopperlabs/laravel-sail-starter-kit ==================================== The skeleton application for the Laravel framework using docker sail and filament. v1.2(5mo ago)410[6 PRs](https://github.com/shopperlabs/laravel-sail-starter-kit/pulls)MITPHPPHP ^8.4.0CI passing Since Nov 10Pushed 4w agoCompare [ Source](https://github.com/shopperlabs/laravel-sail-starter-kit)[ Packagist](https://packagist.org/packages/shopperlabs/laravel-sail-starter-kit)[ GitHub Sponsors](https://github.com/mckenziearts)[ RSS](/packages/shopperlabs-laravel-sail-starter-kit/feed)WikiDiscussions main Synced today READMEChangelog (7)Dependencies (24)Versions (32)Used By (0) [ ![branding for Laravel Sail Starter kit](art/banner-light.png) ](https://shopperlabs.co/) [![PHP 8.4+](https://camo.githubusercontent.com/6d0efcdea311c609d7fe1477138416902370b8f494a169b7951f3e492ae04e8e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d3737374242343f6c6f676f3d706870267374796c653d666c61742d737175617265)](https://php.net) [![Laravel v12.x](https://camo.githubusercontent.com/495c8a51db5297bba0217bc0ab20d7072a4cc6b9783610c9f5b155f755c6ed21/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d7631322e782d4646324432303f7374796c653d666c61742d737175617265)](https://laravel.com) [![Filament 4.1](https://camo.githubusercontent.com/10916c2e1a86bcf1c3019131e7b430da72ec4645014a225b16bdaf855da9b6bf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f46696c616d656e742d342e312d4644414534423f6c6f676f3d66696c616d656e74267374796c653d666c61742d737175617265)](https://filamentphp.com) [![Total Downloads](https://camo.githubusercontent.com/a6ba57d47c453608b46899d72ffd9b711ab56ac52e64b69613a51053917d4920/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686f707065726c6162732f6c61726176656c2d7361696c2d737461727465722d6b69743f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shopperlabs/laravel-sail-starter-kit) [![Latest Stable Version](https://camo.githubusercontent.com/90e9cfcee8032787bcad8f943e9362c676abd64cb84306c87fbb15989b61c829/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73686f707065726c6162732f6c61726176656c2d7361696c2d737461727465722d6b69743f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shopperlabs/laravel-sail-starter-kit) [![Build Status](https://github.com/shopperlabs/laravel-sail-starter-kit/actions/workflows/tests.yml/badge.svg?style=flat-square)](https://github.com/shopperlabs/laravel-sail-starter-kit/actions) [![Coding Standards](https://github.com/shopperlabs/laravel-sail-starter-kit/actions/workflows/quality.yml/badge.svg?style=flat-square)](https://github.com/shopperlabs/laravel-sail-starter-kit/actions/workflows/quality.yml) **Laravel Sail Starter Kit** is an ultra-strict, type-safe [Laravel](https://laravel.com) skeleton engineered for developers who refuse to compromise on code quality. This opinionated starter kit enforces rigorous development standards through meticulous tooling configuration and architectural decisions that prioritize type safety, immutability, and fail-fast principles. Why This Starter Kit? --------------------- [](#why-this-starter-kit) Modern PHP has evolved into a mature, type-safe language, yet many Laravel projects still operate with loose conventions and optional typing. This starter kit changes that paradigm by enforcing: - **100% Type Coverage**: Every method, property, and parameter is explicitly typed - **Zero Tolerance for Code Smells**: Rector and PHPStan at maximum strictness catch issues before they become bugs - **Immutable-First Architecture**: Data structures favor immutability to prevent unexpected mutations - **Fail-Fast Philosophy**: Errors are caught at compile-time, not runtime - **Automated Code Quality**: Pre-configured tools ensure consistent, pristine code across your entire team - **Just Better Laravel Defaults**: Thanks to **[Essentials](https://github.com/nunomaduro/essentials)** / strict models, auto eager loading, immutable dates, and more... This isn't just another Laravel boilerplate—it's a statement that PHP applications can and should be built with the same rigor as strongly-typed languages like Rust or TypeScript. Included Features ----------------- [](#included-features) This Starter kit contains my starting point when developing a new Laravel project using Filament & Sail. Its based on the [Laravel Starter Kit](https://github.com/nunomaduro/laravel-starter-kit) by **[Nuno Maduro](https://x.com/enunomaduro)**, and includes the following features: - ✅ **[Traefik](https://doc.traefik.io/traefik/)** as reverse proxy to serve your application locally and in production, - ✅ **[Laravel Octane](https://laravel.com/docs/12.x/octane)** with FrankenPHP to supercharges your application's performance, - ✅ **[Spatie Roles & Permission](https://filamentphp.com/plugins/bezhansalleh-shield)** with Filament Shield, - ✅ Updated for Laravel 12.\*, Filament 4.3 **and** Livewire 3.6 Getting Started --------------- [](#getting-started) > **Requires [PHP 8.4+](https://php.net/releases/)**. Create your type-safe Laravel application using [Composer](https://getcomposer.org): ``` composer create-project shopperlabs/laravel-sail-starter-kit --prefer-dist example-app # Or laravel new example-app --using=shopperlabs/laravel-sail-starter-kit ``` ### Initial Setup [](#initial-setup) Navigate to your project and complete the setup: ``` cd example-app # Setup project composer dev:setup # Start the development server composer dev:run ``` ### Initialize the Application [](#initialize-the-application) Once your containers are running, initialize the application database and create your admin user: ``` ./vendor/bin/sail artisan app:setup ``` This command will: - Setup `APP_DOMAIN`, `APP_URL` and `ASSET_URL` variables - Run database migrations - Generate roles and permissions (via Filament Shield) - Create the storage symbolic link - Create an admin user with interactive prompts You can also run it non-interactively by providing all options: ``` ./vendor/bin/sail artisan app:setup laravel.local \ --admin-firstname="John" \ --admin-lastname="Doe" \ --admin-username="john.doe" \ --admin-password="your-secure-password" ``` ### Configure Local Domain [](#configure-local-domain) Add your application domain (defined in `APP_DOMAIN` from `.env`) to your hosts file: **Linux/macOS:** ``` sudo sh -c 'echo "127.0.0.1 your-domain.local" >> /etc/hosts' ``` **Windows (as Administrator):** ``` echo 127.0.0.1 your-domain.local >> C:\Windows\System32\drivers\etc\hosts ``` Replace `your-domain.local` with your actual `APP_DOMAIN` value. ### Access Your Application [](#access-your-application) - **Application**: (or your custom domain) - **Admin Panel**: - **MinIO Console**: (sail/password) - **MinIO API**: - **Buggregator**: - **Traefik Dashboard**: - **Vite Dev Server**: **Common Errors** - "Disk named 'media' cannot be accessed": Bucket doesn't exist, run the configuration above. - 403 Forbidden on image URLs: Bucket is not public, apply the public policy above. ### Optional: Browser Testing Setup [](#optional-browser-testing-setup) If you plan to use Pest's browser testing capabilities: ``` npm install playwright npx playwright install ``` ### Verify Installation [](#verify-installation) Run the test suite to ensure everything is configured correctly: ``` composer test ``` You should see 100% test coverage and all quality checks passing. Available Tooling ----------------- [](#available-tooling) ### Development [](#development) - `composer dev:run` - Starts Laravel sail, queue worker, log monitoring, and Vite dev server concurrently ### Code Quality [](#code-quality) - `composer lint` - Runs Rector (refactoring), Pint (PHP formatting), and Prettier (JS/TS formatting) - `composer test:lint` - Dry-run mode for CI/CD pipelines ### Testing [](#testing) - `composer test:type-coverage` - Ensures 100% type coverage with Pest - `composer test:types` - Runs PHPStan at level 10 (maximum strictness) - `composer test:unit` - Runs Pest tests with 100% code coverage requirement - `composer test` - Runs the complete test suite (type coverage, unit tests, linting, static analysis) ### Maintenance [](#maintenance) - `composer update:requirements` - Updates all PHP and NPM dependencies to latest versions License ------- [](#license) **Laravel Sail Starter Kit** was created by **[Arthur Monney](https://x.com/monneyarthur)** inspired by **[Laravel Starter Kit](https://github.com/nunomaduro/laravel-starter-kit)** of **[Nuno Maduro](https://x.com/enunomaduro)** under the **[MIT license](https://opensource.org/licenses/MIT)**. ### Health Score 45 — FairBetter than 91% of packages Maintenance85 Actively maintained with recent releases Popularity9 Limited adoption so far Community9 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits 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 ~14 days Total 7 Last Release 152d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/14105989?v=4)[Arthur Monney](/maintainers/Mckenziearts)[@mckenziearts](https://github.com/mckenziearts) --- Top Contributors [![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (56 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (49 commits)")[![mckenziearts](https://avatars.githubusercontent.com/u/14105989?v=4)](https://github.com/mckenziearts "mckenziearts (18 commits)") --- Tags frameworklaraveldockerfilamentsailshopperlabs ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/shopperlabs-laravel-sail-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/shopperlabs-laravel-sail-starter-kit/health.svg)](https://phpackages.com/packages/shopperlabs-laravel-sail-starter-kit) ``` ### Alternatives [unopim/unopim UnoPim Laravel PIM 10.5k2.4k](/packages/unopim-unopim)[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. 3991.8k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications. 461.7k](/packages/ercogx-laravel-filament-starter-kit)[raugadh/fila-starter Laravel Filament Starter. 625.1k](/packages/raugadh-fila-starter)[nunomaduro/laravel-starter-kit-inertia-react The skeleton application for the Laravel framework. 2071.1k](/packages/nunomaduro-laravel-starter-kit-inertia-react)[slimani/filament-media-manager A media manager plugin for Filament. 126.9k](/packages/slimani-filament-media-manager) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)