README

What's Different from the Official Laravel Starter

PHP >=8.4 baseline with declare(strict_types=1) enforced by Pint.
The default boilerplate is lean and backend/API-friendly rather than frontend-scaffold-heavy.
AppServiceProvider comes preconfigured with useful safeguards like immutable dates and stricter Eloquent.
Models are unguarded by default because we trust our validation more than our patience to keep $fillable in sync.
Tooling is already wired: Pest (parallel tests), PHPStan + Larastan at max level, and Rector for refactors.
Improved testing setup with clear conventions and a dedicated suite for external dependencies.
Laravel Boost configuration prompts are included during setup, and sensible .gitignore rules for Boost are preconfigured. Comes bundled with .ai directory as a starting point for your own AI overrides.
SQLite is set as the default database, offering a clean, minimal starting point that you can easily customize for your preferred database setup.
Formatting is consistent out of the box: Pint for PHP and Prettier for everything else.

Installation

Create application (replace example-app with desired project name):

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

Keep in mind that composer create-project already does most of the setup for you. It will install dependencies, create .env file, generate app key, and prompt you to configure Laravel Boost.

Navigate to your project and complete the setup:

cd example-app

# Initialize git repo
git init
sh install-git-hooks.sh

# Optionally, scaffold API routes with Sanctum or Passport (add --passport flag)
php artisan install:api

Installed Git hooks:

pre-commit runs composer format
pre-push runs composer analyse

If you use Fork and hooks misbehave, see this issue.

Development Commands

Command	Purpose
`composer test`	Run Feature and Unit test suites (`pest --compact --parallel`).
`composer test:external`	Run the External test suite (`--testsuite=External`).
`composer format`	Run Laravel Pint and Prettier formatting.
`composer analyse`	Run static analysis (`phpstan`).
`composer refactor`	Apply Rector refactors.
`composer coverage`	Run tests with local coverage (`pest --coverage`).
`composer coverage:herd`	Run coverage via Laravel Herd tooling.

Tests Structure and Conventions

The tests are organized into three test suites:

tests/Feature: default starting point for validating application behavior. Test from the outside in by calling endpoints directly. Organize feature tests in subfolders by interface type: Web, Api, or Mcp for HTTP endpoints, Console for Artisan commands, etc.
tests/Unit: tests for individual classes aligned with app/ namespaces; strict isolation is not required (using database or involving related classes is acceptable).
tests/External: tests real interactions with external services (no mocking), organized by provider or domain.

If unsure, always start with Feature tests and work inward toward Unit tests as complexity grows.

Do not place unmocked external integration checks in Feature or Unit; keep them in tests/External.

Test descriptions should follow the pattern: <verb> <observable outcome> [when <condition>] [for <actor>].

Additional Folders

Not strictly Laravel-official, but adopted as common practices in the community:

app/Actions: invokable classes for encapsulating business logic.
app/Data: data transfer objects (DTOs).
app/Enums: self-explanatory.
app/Services: for calling external services.

PhpStorm Setup

Recommended setup for consistent formatting:

Settings | Editor | Code Style: ensure "Enable EditorConfig support" is checked.
Settings | PHP | Quality Tools | Laravel Pint: use ruleset from pint.json
Settings | PHP | Quality Tools: set Laravel Pint as external formatter
Settings | Tools | Actions on Save: enable reformat on save
Settings | Languages & Frameworks | JavaScript | Prettier: use automatic config, enable "Run on save", and prefer Prettier config. Include md in Prettier file extensions.

VSCode/Cursor Setup

VSCode and Cursor will automatically detect formatting settings defined in the .vscode/ folder – no additional setup is needed beyond installing the suggested extensions.

adiachenko / starter-kit-laravel

Maintainers

Package info

Statistics

Security