Installer Laravel Package

Getting Started

The laravel/installer package (v5.28.1) is a minimal patch release with no breaking changes or new features. The core functionality (interactive starter kit selection, Symfony 8 support, AI/JSON output, and Pest fixes) remains identical to v5.28.0.

Minimal Steps (Unchanged)

1. Install the binary:

   composer global require laravel/installer
   

   Or via Homebrew (macOS):

   brew install laravel/installer
   

2. Create a new Laravel project (unchanged):

   laravel new project-name
   

3. Interactive Starter Kit Selection (unchanged):

   laravel new my-app --stack=jetstream  # Explicit
   laravel new my-app                   # Interactive prompt
   

4. Serve the app (optional):

   cd project-name && composer run dev
   

First Use Case (Unchanged)

• Starter Kit Workflow: Use --stack for CI/CD or scripts; rely on prompts for local/dev.
• Symfony 8/AI JSON: No changes from v5.28.0.
• Pest Fix: Still preserves RefreshDatabase comments in pest.php.

Implementation Patterns

Core Workflows (Unchanged)

1. Non-Interactive Starter Kit Selection:

   laravel new my-app --stack=jetstream --database=postgres --test=pest
   

2. Interactive Starter Kit (Local Dev):

   laravel new my-app
   

3. Hybrid JSON + Interactive:

   laravel new my-app --json --stack=jetstream --no-interaction
   

4. GitHub Actions Integration:

   - run: laravel new my-app --stack=jetstream --no-interaction
   

Integration Tips (Unchanged)

• Starter Kit Shortcuts (same as v5.28.0):

  Flag	Behavior
  --stack=jetstream	Installs Jetstream (Livewire)
  --stack=fortify	Installs Fortify (API)
  --stack=breeze	Installs Breeze (Blade)
  --stack=none	Skips all starter kits

• AI/JSON Workflow:

  laravel new my-app --json | jq -r '.metadata.stack'
  

• Pest + Starter Kits:

  laravel new my-app --stack=jetstream --test=pest
  

• Database + Starter Kit:

  laravel new my-app --stack=fortify --database=mysql
  

Gotchas and Tips

Pitfalls (Unchanged)

1. GitHub OAuth Credential Flakiness
   • Fix: Ensure COMPOSER_AUTH is configured or use SSH.
2. Interactive Mode in CI
   • Fix: Always specify --stack in non-interactive environments.
3. Starter Kit Overrides
   • Fix: Use --stack=none and manually install starter kits.
4. JSON Output Inconsistencies
   • Fix: Validate metadata.stack in scripts.
5. Symfony 8 + Starter Kits
   • Fix: Pin Symfony versions if conflicts arise.

Debugging (Unchanged)

• Starter Kit Failures:

  laravel new my-app --stack=jetstream --json | jq '.dependencies | keys[]'
  

• Interactive Mode Debugging:

  laravel new my-app --verbose
  

• GitHub OAuth Errors:

  composer config -g github-oauth.github.com "ghp_..."
  

Configuration Quirks (Unchanged)

1. Starter Kit Defaults: Defaults to "None" if no --stack is provided.
2. JSON Output Fields: Includes metadata.stack and metadata.starter_kit_version.
3. Interactive Mode Behavior: Skips prompts if --database or --test are provided.
4. Windows Line Endings: JSON output may include \r\n; handle in scripts.

NO_UPDATE_NEEDED