README

Laravel Starter Kit

A modern, developer-friendly Laravel starter kit featuring a curated selection of tools and a polished, feature-reached admin panel — ready for production from day one.

✨ Features

Laravel 12, PHP 8.3+ support
Choose your Admin Panel during setup:
- Filament — beautiful, customizable full-stack components
- Moonshine — comfortable, user-friendly admin panel
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
Pre-configured with:
- Pest + Larastan for clean and safe testing
- Laravel Debugbar, Ray, Pint, and Git hooks

📦 Installation

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

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

Whether to install Filament or Moonshine admin panel (or skip both)
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.

✅ If you agree to automatic build and launch with Sail, the setup will:

Install selected composer packages
Build and start Sail containers
Generate an app key and run post-install artisan commands specific to installed packages (e.g., filament:install --panels or moonshine:install)

❌ If you decline, run them manually:

chmod 755 ./sail
./sail up -d --build
./sail composer install
./sail artisan key:gen
./sail artisan sto:li

⚙️ 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 (if you use auto-build):

Package	Команды
`moonshine/moonshine`	`php artisan moonshine:install`
`filament/filament`	`php artisan filament:install --panels`
`darkaonline/l5-swagger`	`php artisan install:api`
`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 opt:cle` `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

Details