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
Ready-to-use Swagger API docs with l5-swagger
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 and Swagger docs
Optional features like Telegram bot integration, Ray debugger, Media Library, and Permissions

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.

🛠 Post-Install Commands

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

Package	Команды
`darkaonline/l5-swagger`	`php artisan vendor:publish --provider="L5Swagger\L5SwaggerServiceProvider"` `php artisan l5-swagger:generate`
`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