cjmellor/boost-ide-bundle

Extended IDE support bundle for Laravel Boost. Multiple development environments, one package.

v1.0.1 2025-10-20 14:08 UTC

Requires

• php: ^8.1
• illuminate/support: ^10.49.0|^11.45.3|^12.28.1

Requires (Dev)

• laravel/boost: ^1.4
• laravel/pint: ^1.0
• orchestra/testbench: ^8.36.0|^9.15.0|^10.6
• pestphp/pest: ^2.36.0|^3.8.4|^v4.1.2
• pestphp/pest-plugin-arch: ^v2.7.0|^3.0|^4.0
• pestphp/pest-plugin-laravel: ^v2.4.0|^3.0|^4.0

MIT

• Chris Mellor

• laravel
• boost-ide-bundle

README

Boost IDE Bundle

Extended IDE support bundle for Laravel Boost. It provides a simple, convention-based way to register multiple IDE-aware code environments in your Laravel application.

Features

• Automatic discovery of environment classes
• Zero configuration — uses Laravel package auto-discovery
• Compatible with Laravel 10, 11, and 12; PHP 8.1+

Included environments:

• Cline
• KiloCode
• Kiro
• RooCode
• Trae
• Warp

Warning

I (the maintainer) don't use all these IDE/Agents, so I cannot guarentee the config locations are correct. If they are wrong, please submit a PR to fix it.

Requirements

• PHP ^8.1
• Laravel ^10 | ^11 | ^12
• Laravel Boost 1.4

Installation

Install via Composer:

composer require cjmellor/boost-ide-bundle --dev

# Ensure Laravel Boost is present in your app (if not already installed)
composer require laravel/boost:^1.4 --dev

This package uses Laravel’s auto-discovery. No manual provider registration is needed.

How It Works

• The service provider scans src/CodeEnvironments for *.php classes.
• Each class must extend Laravel\Boost\Install\CodeEnvironment\CodeEnvironment and implement name(): string.
• On boot, the bundle registers each environment with Laravel\Boost\Boost::registerCodeEnvironment($name, $class).

Usage

Out of the box, the environment classes in src/CodeEnvironments are registered automatically.

Adding Your Own Environment

Create a class in src/CodeEnvironments that extends Boost’s \Laravel\Boost\Install\CodeEnvironment\CodeEnvironment and implement the required methods.

Drop the file in src/CodeEnvironments and it will be discovered automatically on the next boot.

Conventions

No dedicated configuration file is required; the bundle follows these conventions:

• Files are read from src/CodeEnvironments
• Class names must be ucfirst (first letter uppercase)
• name() must return a lowercase string

Contributing

Contributions are welcome! Please:

• Fork the repository and create a feature branch
• Keep changes focused and follow the existing style
• Run composer lint before submitting
• Open a pull request and follow the guideline template

Security Vulnerabilities

Please report any security issues directly to the maintainer via GitHub issues or email.

License

The MIT License (MIT). See LICENSE for details.