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...

Requires PHP 8.4+.

Differences

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

```bash
cd example-app

# Install PHP dependencies with optimized autoloader
composer install

# Install and build frontend assets
npm install
npm run build

# Configure your environment
cp .env.example .env
php artisan key:generate

# Run database migrations
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.

npm install playwright
npx playwright install

Verify Installation

Run the test suite to ensure everything is configured correctly:

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