PHPackages joelbutcher/laravel-skeleton - 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. joelbutcher/laravel-skeleton ActiveProject[Framework](/categories/framework) joelbutcher/laravel-skeleton ============================ The skeleton application for the Laravel framework. v1.0.2(2mo ago)11MITPHPPHP ^8.3CI passing Since Apr 8Pushed 2mo agoCompare [ Source](https://github.com/joelbutcher/laravel-skeleton)[ Packagist](https://packagist.org/packages/joelbutcher/laravel-skeleton)[ RSS](/packages/joelbutcher-laravel-skeleton/feed)WikiDiscussions main Synced 2w ago READMEChangelog (3)Dependencies (22)Versions (4)Used By (0) README ====== [](#readme) An opinionated, coding agent-ready, Laravel 13 application skeleton preconfigured with strict code quality tooling, Octane-ready conventions, and a comprehensive testing pipeline. Use this as a starting point for new Laravel services. What's Included --------------- [](#whats-included) Out of the box, the skeleton provides: - **Laravel Octane** with FrankenPHP worker — high-performance, long-running process model - **Custom ULID primary keys** — `App\Support\Ulids\HasUlids` trait and `UlidCast`, enforced over Laravel's built-in implementation - **Brick\\DateTime integration** — `LocalDateCast` and `LocalDateTimeCast` for Eloquent, replacing Carbon entirely - **Five-layer testing pipeline** — PHPUnit, Behat BDD, PHPStan (level max), Infection mutation testing, Mago linting - **100% coverage and mutation score** — enforced automatically; builds fail if either drops - **Strict linting** — final controllers, identity comparison, strict types, no eval/shell/globals - **Concurrent dev server** — single command runs Octane, queue worker, log tailing, and Vite Tech Stack ---------- [](#tech-stack) LayerTechnologyVersionLanguagePHP8.5FrameworkLaravel13App ServerLaravel Octane2DatabaseSQLite (dev)-FrontendTailwind CSS4Build ToolVite8Date/TimeBrick\\DateTime0.9IDsCustom ULIDs-Getting Started --------------- [](#getting-started) ### Prerequisites [](#prerequisites) - PHP 8.5+ - Composer - Node.js and npm - SQLite ### Setup [](#setup) ``` composer setup ``` This runs the full setup sequence: installs PHP and Node dependencies, generates an app key, runs migrations, and builds frontend assets. ### Development Server [](#development-server) ``` composer run dev ``` Starts four processes concurrently: - **server** - `php artisan serve` - **queue** - `php artisan queue:listen` - **logs** - `php artisan pail` (log tailing) - **vite** - `npm run dev` (hot-reload) Project Structure ----------------- [](#project-structure) ``` app/ Models/ Eloquent models (ULID primary keys) Support/ DateTime/ LocalDateCast, LocalDateTimeCast (Brick\DateTime) Ulids/ Custom HasUlids trait and UlidCast config/ Laravel configuration (including octane.php) database/ factories/ Model factories migrations/ Database migrations seeders/ Database seeders features/ Behat BDD feature files (Gherkin) resources/ css/ Tailwind CSS v4 entrypoint js/ JavaScript entrypoint (Axios) views/ Blade templates routes/ web.php Web routes console.php Console commands tests/ Behat/FeatureContext.php Behat step definitions Feature/ PHPUnit feature tests Unit/ PHPUnit unit tests ``` Conventions ----------- [](#conventions) ### No Carbon or DateTime [](#no-carbon-or-datetime) All date/time values use `Brick\DateTime\LocalDate` or `Brick\DateTime\LocalDateTime`. Carbon and PHP's `DateTime` are banned via PHPStan disallowed-namespace rules. Custom Eloquent casts (`LocalDateCast`, `LocalDateTimeCast`) handle serialisation. ### Custom ULIDs [](#custom-ulids) Use `App\Support\Ulids\HasUlids` instead of Laravel's built-in `HasUlids` trait. This is enforced by PHPStan. The custom implementation includes a `UlidCast` for Eloquent attribute casting. ### Octane-Safe Code [](#octane-safe-code) The application runs on Laravel Octane, which boots the app once and reuses it across requests: - Use `scoped()` instead of `singleton()` for request-scoped bindings. - Never inject the container, request, or config repository into a singleton constructor. - Never append to static properties (they persist across requests). ### Mago Linter [](#mago-linter) PHP linting uses [Mago](https://github.com/carthage-software/mago) with strict rules: - Controllers must be `final` - Prefer arrow functions and static closures - Identity comparison required (`===` / `!==`) - `declare(strict_types=1)` enforced - Shell execution, eval, FFI, and globals are prohibited Testing ------- [](#testing) ### Running Tests [](#running-tests) ``` # All tests php artisan test --compact # Single test by name php artisan test --compact --filter=testName # Unit tests with coverage composer test:unit # Static analysis (PHPStan level max) composer test:types # Mutation testing (100% MSI required) composer test:mutation # BDD acceptance tests (Behat) composer test:features # Unit tests + static analysis composer test ``` ### Test Strategy [](#test-strategy) LayerToolWhat It CoversUnitPHPUnit 12Individual classes and castsFeaturePHPUnit 12HTTP requests, model integrationAcceptanceBehat 3User-facing behaviour (Gherkin scenarios)StaticPHPStan (level max)Type safety, Octane compatibility, convention enforcementMutationInfectionKill-all-mutants guarantee (100% MSI)Tests run against **in-memory SQLite** (`phpunit.xml.dist`). Behat scenarios bootstrap a full Laravel application with `RefreshDatabase`. ### Coverage Requirements [](#coverage-requirements) - **100% code coverage** enforced by `robiningelbrecht/phpunit-coverage-tools` (tests fail on low coverage). - **100% mutation score** enforced by Infection (all mutants must be killed). Code Quality ------------ [](#code-quality) ``` # Format code composer format # Check formatting (CI-friendly) composer format:check # Lint composer lint # Lint with autofix composer lint:fix # Run everything before finishing work composer before-stopping ``` `composer before-stopping` runs the full quality pipeline: unit tests, static analysis, feature tests, mutation testing, formatting, and linting. Static Analysis --------------- [](#static-analysis) PHPStan runs at **level max** with: - [Larastan](https://github.com/larastan/larastan) for Laravel-specific analysis - Octane compatibility checks - Custom disallowed-namespace rules (enforcing Brick\\DateTime and custom ULIDs) - [PSL PHPStan extension](https://github.com/php-standard-library/phpstan-extension) for PHP Standard Library Dependencies ------------ [](#dependencies) ### Runtime [](#runtime) PackagePurpose`laravel/framework`Core framework`laravel/octane`High-performance application server`brick/date-time`Immutable date/time library`gosuperscript/monads`Monad utilities`php-standard-library/php-standard-library`PSL utilities`laravel/tinker`REPL for debugging### Development [](#development) PackagePurpose`phpunit/phpunit`Unit and feature testing`behat/behat`BDD acceptance testing`infection/infection`Mutation testing`phpstan/phpstan` + `larastan/larastan`Static analysis`carthage-software/mago`PHP linting and formatting`spatie/laravel-ray`Debug output to Ray`laravel/pail`Real-time log tailingDeployment ---------- [](#deployment) The application includes a FrankenPHP worker script (`public/frankenphp-worker.php`) and is configured for Laravel Octane, making it ready for high-performance deployment via [Laravel Cloud](https://cloud.laravel.com/) or containerised environments. License ------- [](#license) This project is licensed under the [MIT License](https://opensource.org/licenses/MIT). ### Health Score 38 — LowBetter than 83% of packages Maintenance85 Actively maintained with recent releases Popularity3 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 ~0 days Total 3 Last Release 79d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/eb6903ee363d9201681e47a2dcbe12148b7d299dd9e37229cad774ecd923fd6e?d=identicon)[joelbutcher](/maintainers/joelbutcher) --- Top Contributors [![joelbutcher](https://avatars.githubusercontent.com/u/7163152?v=4)](https://github.com/joelbutcher "joelbutcher (5 commits)") --- Tags frameworklaravel ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/joelbutcher-laravel-skeleton/health.svg) ``` [![Health](https://phpackages.com/badges/joelbutcher-laravel-skeleton/health.svg)](https://phpackages.com/packages/joelbutcher-laravel-skeleton) ``` ### Alternatives [laravel/laravel The skeleton application for the Laravel framework. 84.5k62.4M1.0k](/packages/laravel-laravel)[unopim/unopim UnoPim Laravel PIM 10.3k2.2k](/packages/unopim-unopim)[bagisto/bagisto Bagisto Laravel E-Commerce 27.4k169.0k9](/packages/bagisto-bagisto)[nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[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. 3861.7k](/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) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)