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):

🧪 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

📚 Useful Links

• API Responder Documentation
• Spatie Laravel Data
• Filament Docs
• Moonshine Admin