README

Ai Dev Quickstart

Ai Dev Quickstart gives a Laravel application an editable development baseline. Its installer adds AI instructions and Laravel skills, a FrankenPHP and PostgreSQL Docker setup, Pint, PHPStan/Larastan, and Rector configuration, plus Composer scripts for the quality suite. Everything it installs belongs to your application and can be customized.

Installation

Install the package as a development dependency, then run the installer from your Laravel application's root:

composer require --dev mdecode/ai-dev-quickstart
php artisan ai-dev-quickstart:install

The installer adds:

AGENTS.md, CLAUDE.md, and starter Laravel skills in .agents/skills/;
docker-compose.yml and a FrankenPHP Dockerfile with PostgreSQL;
pint.json, phpstan.neon, and rector.php;
quality scripts in composer.json; and
compatible development dependencies for Pest, PHPStan/Larastan, and Rector.

When AGENTS.md or CLAUDE.md already exists, the installer asks whether to append the baseline or replace it; appending is the default. Other existing files, Composer constraints, and scripts are preserved. Use --force only when you intentionally want to replace generated files:

php artisan ai-dev-quickstart:install --force

For an offline or staged setup, --no-composer writes resources and Composer scripts without installing dependencies. Run the installer again without this option when Composer is available:

php artisan ai-dev-quickstart:install --no-composer

Usage

Customize the installed instructions, skills, Docker files, and quality configuration for your application. Re-running the installer preserves them unless --force is supplied.

Docker

Start the included FrankenPHP application and PostgreSQL services:

docker compose up --build

The application is available at http://localhost:8000 by default. Set APP_PORT or DB_* values to customize the Compose services.

Quality commands

# Apply Rector and Pint fixes
composer lint

# Check Rector and Pint without changing files
composer lint:check

# Check Pest type coverage
composer test:type-coverage

# Run Pest with exact coverage
composer test:unit

# Run PHPStan/Larastan
composer test:types

# Run the complete quality suite
composer test

The exact-coverage test command requires Xdebug, which is included in the generated FrankenPHP image.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Thank you for considering contributing to Ai Dev Quickstart! Please review our contributing guide to get started.

mdecode / ai-dev-quickstart

Maintainers

Package info

Fund package maintenance!

Statistics

Security