README

Laravel Starter Kit

A modern, developer-friendly Laravel starter kit featuring a curated selection of tools and a pragmatic setup flow — ready for production-focused application work from day one.

✨ Features

Laravel 13, PHP 8.4+ support
Optional custom admin frontend foundation during setup:
- Inertia 3 + Vue 3 + TypeScript
- Nuxt UI 4 + Tailwind CSS 4
- Ziggy, Vue I18n, VueUse, Valibot
Choose your API utility during setup:
- pepperfm/api-responder-for-laravel
- spatie/laravel-data
API scaffolding with Laravel Sanctum
Ready-to-use Swagger Nuxt UI docs with pepperfm/swagger-nuxt-ui-for-laravel
Optional observability tools during setup:
Telegram bot integration via defstudio/telegraph
Local development environment powered by Laravel Sail
UUID primary keys for the base user model
Pre-configured with:
- Pest + Larastan + Laravel PAO for clean and agent-friendly testing
- Laravel Debugbar, Ray, and Pint

📦 Installation

laravel new example-app --using=pepperfm/laravel-starter-kit --database=pgsql

The --database=pgsql flag is important: Laravel Installer defaults custom starter kits to SQLite when no database driver is specified. When using Sail, choose the Sail runtime during setup so containers are available for Laravel Installer's final migration step.

After creating your project, the interactive starter:setup command will run automatically, helping you choose:

Whether setup commands should run on the host machine, through Sail, or auto-detect a running Sail container
Whether to publish the custom admin frontend foundation
API support packages, Sanctum, and Swagger Nuxt UI docs
Optional features like Log Viewer, Horizon, Telescope, Pulse, Telegram bot integration, Ray debugger, Media Library, and Permissions
Review an installation summary before Composer, frontend, or post-install Artisan commands run

You will also be prompted to configure environment variables WWWUSER and WWWGROUP for proper permissions. The setup command also normalizes the PostgreSQL DB_* variables so they are active after laravel new.

If you choose Sail and the app container is not running yet, setup can start Sail with ./sail up -d --build before installing selected packages.

During setup, the selected command runtime controls:

Installing selected composer packages
Publishing selected frontend preset files and installing frontend dependencies
Running post-install artisan commands specific to installed packages

If you skip Sail during setup, you can start it later:

chmod 755 ./sail
./sail up -d --build

⚙️ Setup Command

Run manually anytime:

php artisan starter:setup

Interactive setup will help you customize your project features and install optional packages with their post-install steps.

Preset mode is available when you want a repeatable setup path:

php artisan starter:setup --preset=api
php artisan starter:setup --preset=admin
php artisan starter:setup --preset=observability
php artisan starter:setup --preset=full

Available presets:

Preset	Includes
`api`	Sanctum, Swagger Nuxt UI docs, Spatie Laravel Data
`admin`	Custom Inertia + Vue + Nuxt UI admin frontend foundation
`observability`	Log Viewer, Horizon, Pulse, Telescope as a dev dependency
`full`	`admin` + `api` + `observability`

🛠 Post-Install Commands

For installed packages, the following post-install artisan commands will run automatically unless --no-post is used:

Package	Команды
`laravel/sanctum`	`php artisan install:api --without-migration-prompt`
`opcodesio/log-viewer`	`php artisan log-viewer:publish`
`laravel/horizon`	`php artisan horizon:install`
`laravel/telescope`	`php artisan telescope:install` `php artisan migrate`
`laravel/pulse`	`php artisan vendor:publish --provider="Laravel\Pulse\PulseServiceProvider"` `php artisan migrate`
`defstudio/telegraph`	`php artisan vendor:publish --tag="telegraph-migrations"` `php artisan migrate`
`spatie/laravel-medialibrary`	`php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"` `php artisan migrate`
`spatie/laravel-permission`	`php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"` `php artisan optimize:clear` `php artisan migrate`

🧪 Testing & Quality

make pint        # Show unstaged files with codestyle issues
make pint-hard   # Fix codestyle issues automatically
make stan        # Run Larastan (static analysis)
make test        # Run all tests via Pest

pepperfm / laravel-starter-kit

Maintainers

Package info

Statistics

Security