Search by

pepperfm / laravel-starter-kit

PepperFM

The skeleton application for the Laravel framework.

Package info

github.com/pepperfm/laravel-starter-kit

Type:project

pkg:composer/pepperfm/laravel-starter-kit

Statistics

Installs: 28

Dependents: 0

Suggesters: 0

Stars: 2

Open Issues: 0

dev-master 2026-11-17 18:24 UTC

README

Latest Version on Packagist Total Downloads

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

๐Ÿ“ฆ 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.json are not required again.
  • Preset files and vendor migrations are published, without running migrations yet.
  • .env is prepared for host connections, while config/database.php resolves 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=pgsql does 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 run starter:setup manually instead. The starter's --no-migrate flag 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

๐Ÿ“š Useful Links