README

Laravel TALL Starter Kit is fork of nunomaduro strict Laravel skeleton - for those who demand meticulous precision in their projects.

Tools like PHPStan, Pest, Rector, Pint, and Prettier are pre-configured to be as strict as possible. E.g: 100% type and code coverage, PHPStan level max, Rector with max privatization, and more...

Modifications from upstream include:

TALL stack (TailwindCSS, Alpine.js, Laravel, Livewire) by default.
Removed php artisan:make action from NunoMaduro\Essentials in favor of lorisleiva/laravel-actions.
Removed Commercial AI (Cursor, Junie, etc) in favor of sst/opencode.
Added livewire/flux (PRO) Livewire Components.

Create Project

⚡️ Create your project using Composer:

composer create-project ahosker/laravel-tall-starter-kit --prefer-dist example-app

cd example-app

composer install
npm install
npm run build
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan flux:activate #if, you have a PRO license...

php artisan serve # serve the application...

Features

🥃 Comes with Laravel Essentials, changes defaults in Laravel for more strict usage:

Strict Models
Auto Eager Loading
Immutable Dates
Force HTTPS
Safe Console
Asset Prefetching
and more...

🧹 Keep a modern codebase with Pint, Rector, and Prettier:

Every single rule in these tools is customized so they are most strict as possible.

composer lint
composer test:lint # on ci...

🧨 Check type coverage with Pest:

composer test:type-coverage # 100% type coverage...

⚗️ Run static analysis using PHPStan:

composer test:types # level max by default

✅ Run unit tests using PEST

composer test:unit # 100% test coverage...

🚀 Run the entire test suite:

composer test # the entire test suite...

⚙️ Better defaults for testing, including:

Fake sleeps
Stray http requests
Browser testing
and more...

💭 Different application structure with:

app/Actions - for application actions
app/Enums - for enumerations
and more...

🤖 Agent coding style rules with Laravel Boost, with support for:

PHPStorm Junie
Claude AI
and more...

Notes to Self

Keep your fork up to date with the original repo:

git fetch upstream # get latest changes from original repo
git checkout master # switch to your local master branch 3.a git merge upstream/main # merge changes from original repo into your local master branch 3.b. or git rebase upstream/main # rebase changes from original repo into your local master branch
git push origin master # push changes to your forked repo

TODO

Add Tests for custom features
Add OpenCode Agents/Plugins/Prompts and Agents.MD

License

Laravel Starter Kit was created by Nuno Maduro under the MIT license.

ahosker / laravel-tall-starter-kit

Maintainers

Details