pepperfm / laravel-starter-kit
The skeleton application for the Laravel framework.
Package info
github.com/pepperfm/laravel-starter-kit
Type:project
pkg:composer/pepperfm/laravel-starter-kit
Requires
- php: ^8.5
- laravel/framework: ^13.0
- laravel/prompts: ^0.3.5
- laravel/tinker: ^3.0
Requires (Dev)
- fakerphp/faker: ^1.23
- fruitcake/laravel-debugbar: ^4.2
- laramint/laravel-brain: ^2.2
- larastan/larastan: ^3.2
- laravel/boost: ^2.4
- laravel/pao: ^1.0
- laravel/pint: ^1.13
- laravel/sail: ^1.26
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.6
- pepperfm/ai-guidelines: ^1.5
- pestphp/pest: ^4.0
- pestphp/pest-plugin-laravel: ^4.0
- spatie/laravel-ray: ^1.43
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-17 18:24:17 UTC
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.5+ requirement
- Optional custom admin frontend foundation during setup:
- Inertia 3 + Vue 3 + TypeScript
- Nuxt UI 4 + Tailwind CSS 4 (based on Nuxt UI Dashboard primitives, without requiring Nuxt)
- Ziggy, Vue I18n, VueUse, Valibot
- Independently choose API components during setup (none are required together):
- Laravel Sanctum for token authentication and API routes
- Swagger Nuxt UI for API documentation
- spatie/laravel-data for DTOs
- pepperfm/api-responder-for-laravel for response helpers
- 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
Requires PHP 8.5, Composer, and the Laravel Installer. For Sail development, also install Docker Compose. The host must have the PostgreSQL PDO extension if you use the command below: Laravel Installer runs its own migrations on the host.
laravel new example-app --using=pepperfm/laravel-starter-kit --database=pgsql
The installer creates the application and initializes its key before invoking the interactive
starter:setup --installer-hook hook. In the hook you can select the host or Sail runtime,
admin frontend, independent API components, and optional observability packages. The plan is shown
before any project files are modified.
During that hook:
- Optional Composer packages are installed on the host, before any Docker build; packages
already present in
composer.jsonare not required again. - Preset files and vendor migrations are published, without running migrations yet.
.envis prepared for host connections, whileconfig/database.phpresolves loopback PostgreSQL/Redis to service names when the application runs under Sail. Custom remote hostnames/URLs and existing non-placeholder credentials are preserved.- If Sail is selected, Docker Compose starts after Composer and waits for service health. Its full build output is streamed to the terminal.
After that hook, Laravel Installer resumes: it configures APP_URL and the selected
database, runs artisan migrate on the host (for the explicit --database=pgsql flag),
then chooses and installs/builds frontend dependencies. The starter hook deliberately does
not run those stages a second time. Installer respects --npm, --pnpm,
--bun, --yarn and --no-node. With no explicit package manager,
its current lockfile detection typically chooses Bun for this repository.
Installer limitation:
laravel new ... --database=pgsqldoes not expose a migration opt-out. If you need to review/decline migrations or cannot migrate from the host, create the project with Composer and runstarter:setupmanually instead. The starter's--no-migrateflag applies only to manual setup. See the lifecycle analysis for source references and trade-offs.
The admin preset replaces only pristine Laravel skeleton package.json,
vite.config.js and resources/css/app.css (plus missing files). Customized files are never
overwritten. Re-running setup preserves existing preset files and skips already-installed Composer
requirements. If installation stops partway through, fix the failure and run setup again; it does
not implement transactional rollback.
The panel uses Laravel session authentication. Guests visiting /panel are redirected
to /panel/login; failed attempts are rate-limited and logout invalidates the session.
There is no public registration. After migrations, create the first panel user with
php artisan panel:user. Any authenticated application user can currently access the
panel; use policies/roles for production authorization.
โ๏ธ Manual setup
php artisan starter:setup
php artisan starter:setup --preset=api
php artisan starter:setup --preset=admin
php artisan starter:setup --preset=observability
php artisan starter:setup --preset=full
# Prevent post-install Artisan commands, migrations, and Node installation:
php artisan starter:setup --preset=full --no-post --no-migrate --skip-node
Manual setup asks separately whether to run pending migrations and install frontend
dependencies. Use --no-migrate or --skip-node to suppress those steps. A manually
selected Sail runtime still requires host Composer, but the remaining Artisan and optional
frontend commands run inside Sail once healthy.
| Preset | Includes |
|---|---|
api |
Sanctum, Swagger documentation and Laravel Data |
admin |
Inertia + Vue + Nuxt UI panel |
observability |
Log Viewer, Horizon, Pulse, Telescope (dev dependency) |
full |
Admin + API + observability |
Sanctum is installed once using Composer; routes/api.php and the HasApiTokens trait are
set up without invoking install:api, which would run Composer internally.
Horizon, Telescope, Pulse, Telegraph, MediaLibrary and Permissions publish their required
assets/migrations before the migration stage.
For a more detailed execution map, failure behavior, and reproducible smoke tests, read Installer Lifecycle.
๐งช 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