Merge branch 'main' into dont-overwrite-invalid-json

Author: ashleyhindle

CHANGELOG.md

@@ -1,6 +1,20 @@
 # Release Notes
 
-## [Unreleased](https://github.com/laravel/boost/compare/v1.0.17...main)
+## [Unreleased](https://github.com/laravel/boost/compare/v1.0.18...main)
+
+## [v1.0.18](https://github.com/laravel/boost/compare/v1.0.17...v1.0.18) - 2025-08-16
+
+### What's Changed
+
+* fix: Prevent install command from breaking when `/tests` doesn't exist by [@sagalbot](https://github.com/sagalbot) in https://github.com/laravel/boost/pull/93
+* [1.x] Add enabled option to `config/boost.php`. by [@xiCO2k](https://github.com/xiCO2k) in https://github.com/laravel/boost/pull/143
+
+### New Contributors
+
+* [@sagalbot](https://github.com/sagalbot) made their first contribution in https://github.com/laravel/boost/pull/93
+* [@xiCO2k](https://github.com/xiCO2k) made their first contribution in https://github.com/laravel/boost/pull/143
+
+**Full Changelog**: https://github.com/laravel/boost/compare/v1.0.17...v1.0.18
 
 ## [v1.0.17](https://github.com/laravel/boost/compare/v1.0.16...v1.0.17) - 2025-08-14
 

README.md

@@ -73,7 +73,7 @@ Laravel Boost includes AI guidelines for the following packages and frameworks.
 | Pest | core, 4.x |
 | PHPUnit | core |
 | Pint | core |
-| TailwindCSS | core, 3.x, 4.x |
+| Tailwind CSS | core, 3.x, 4.x |
 | Livewire Volt | core |
 | Laravel Folio | core |
 | Enforce Tests | conditional |

all.php

@@ -8,35 +8,15 @@
 use Laravel\Boost\Install\GuidelineConfig;
 use Laravel\Boost\Install\Herd;
 use Laravel\Roster\Roster;
-use Orchestra\Testbench\Concerns\CreatesApplication;
-
-// Create a simple class that uses Orchestra Testbench to bootstrap Laravel
-$testbench = new class
-{
-    use CreatesApplication;
-
-    protected function getPackageProviders($app)
-    {
-        // No need to register Laravel Boost since we're just using Blade
-        return [];
-    }
-
-    protected function defineEnvironment($app)
-    {
-        // Set a .test URL to enable Herd guidelines if needed
-        $app['config']->set('app.url', 'http://localhost.test');
-    }
-
-    public function bootstrap()
-    {
-        $app = $this->createApplication();
-
-        return $app;
-    }
-};
-
-// Bootstrap the Laravel application
-$app = $testbench->bootstrap();
+use Orchestra\Testbench\Foundation\Application as Testbench;
+use Orchestra\Testbench\Foundation\Config as TestbenchConfig;
+
+// Bootstrap the Laravel application using Testbench
+$app = Testbench::createFromConfig(new TestbenchConfig([
+    'env' => [
+        'APP_URL=http://localhost.test',
+    ],
+]), options: ['enables_package_discoveries' => false]);
 
 // Create a mock Roster that returns ALL packages from .ai/ directory
 $mockRoster = new class extends Roster

composer.json

@@ -13,18 +13,18 @@
         "source": "https://github.com/laravel/boost"
     },
     "require": {
-        "php": "^8.1|^8.2",
+        "php": "^8.1",
         "guzzlehttp/guzzle": "^7.9",
         "illuminate/console": "^10.0|^11.0|^12.0",
         "illuminate/contracts": "^10.0|^11.0|^12.0",
         "illuminate/routing": "^10.0|^11.0|^12.0",
         "illuminate/support": "^10.0|^11.0|^12.0",
-        "laravel/mcp": "^0.1.0",
+        "laravel/mcp": "^0.1.1",
         "laravel/prompts": "^0.1.9|^0.3",
         "laravel/roster": "^0.2"
     },
     "require-dev": {
-        "laravel/pint": "^1.14|^1.23",
+        "laravel/pint": "^1.14",
         "mockery/mockery": "^1.6",
         "orchestra/testbench": "^8.22.0|^9.0|^10.0",
         "pestphp/pest": "^2.0|^3.0",

config/boost.php

@@ -4,6 +4,19 @@
 
 return [
 
+    /*
+    |--------------------------------------------------------------------------
+    | Boost Master Switch
+    |--------------------------------------------------------------------------
+    |
+    | This option may be used to disable all Boost functionality - which
+    | will prevent Boost's routes from being registered and will also
+    | disable Boost's browser logging functionality from operating.
+    |
+    */
+
+    'enabled' => env('BOOST_ENABLED', true),
+
     /*
     |--------------------------------------------------------------------------
     | Boost Browser Logs Watcher

src/BoostServiceProvider.php

@@ -26,6 +26,10 @@ public function register(): void
             'boost'
         );
 
+        if (! $this->shouldRun()) {
+            return;
+        }
+
         $this->app->singleton(Roster::class, function () {
             $lockFiles = [
                 base_path('composer.lock'),
@@ -55,20 +59,21 @@ public function register(): void
 
     public function boot(Router $router): void
     {
-        // Only enable Boost on local environments
-        if (! app()->environment(['local', 'testing']) && config('app.debug', false) !== true) {
+        if (! $this->shouldRun()) {
             return;
         }
 
-        // @phpstan-ignore-next-line
         Mcp::local('laravel-boost', Boost::class);
 
         $this->registerPublishing();
         $this->registerCommands();
         $this->registerRoutes();
-        $this->registerBrowserLogger();
-        $this->callAfterResolving('blade.compiler', fn (BladeCompiler $bladeCompiler) => $this->registerBladeDirectives($bladeCompiler));
-        $this->hookIntoResponses($router);
+
+        if (config('boost.browser_logs_watcher', true)) {
+            $this->registerBrowserLogger();
+            $this->callAfterResolving('blade.compiler', fn (BladeCompiler $bladeCompiler) => $this->registerBladeDirectives($bladeCompiler));
+            $this->hookIntoResponses($router);
+        }
     }
 
     private function registerPublishing(): void
@@ -175,10 +180,24 @@ private static function mapJsTypeToPsr3Level(string $type): string
 
     private function hookIntoResponses(Router $router): void
     {
-        if (! config('boost.browser_logs_watcher', true)) {
-            return;
+        $router->pushMiddlewareToGroup('web', InjectBoost::class);
+    }
+
+    private function shouldRun(): bool
+    {
+        if (! config('boost.enabled', true)) {
+            return false;
         }
 
-        $router->pushMiddlewareToGroup('web', InjectBoost::class);
+        if (app()->runningUnitTests()) {
+            return false;
+        }
+
+        // Only enable Boost on local environments or when debug is true
+        if (! app()->environment('local') && config('app.debug', false) !== true) {
+            return false;
+        }
+
+        return true;
     }
 }

src/Console/ExecuteToolCommand.php

@@ -14,6 +14,8 @@ class ExecuteToolCommand extends Command
 
     protected $description = 'Execute a Boost MCP tool in isolation (internal command)';
 
+    protected $hidden = true;
+
     public function handle(): int
     {
         $toolClass = $this->argument('tool');

tests/Feature/BoostServiceProviderTest.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Support\Facades\Config;
+use Laravel\Boost\BoostServiceProvider;
+
+beforeEach(function () {
+    $this->refreshApplication();
+    Config::set('logging.channels.browser', null);
+});
+
+describe('boost.enabled configuration', function () {
+    it('does not boot boost when disabled', function () {
+        Config::set('boost.enabled', false);
+        app()->detectEnvironment(fn () => 'local');
+
+        $provider = new BoostServiceProvider(app());
+        $provider->register();
+        $provider->boot(app('router'));
+
+        $this->artisan('list')->expectsOutputToContain('boost:install');
+    });
+
+    it('boots boost when enabled in local environment', function () {
+        Config::set('boost.enabled', true);
+        app()->detectEnvironment(fn () => 'local');
+
+        $provider = new BoostServiceProvider(app());
+        $provider->register();
+        $provider->boot(app('router'));
+
+        expect(app()->bound(Laravel\Roster\Roster::class))->toBeTrue();
+        expect(config('logging.channels.browser'))->not->toBeNull();
+    });
+});
+
+describe('environment restrictions', function () {
+    it('does not boot boost in production even when enabled', function () {
+        Config::set('boost.enabled', true);
+        Config::set('app.debug', false);
+        app()->detectEnvironment(fn () => 'production');
+
+        $provider = new BoostServiceProvider(app());
+        $provider->register();
+        $provider->boot(app('router'));
+
+        expect(config('logging.channels.browser'))->toBeNull();
+    });
+
+    describe('testing environment', function () {
+        it('does not boot boost when debug is false', function () {
+            Config::set('boost.enabled', true);
+            Config::set('app.debug', false);
+            app()->detectEnvironment(fn () => 'testing');
+
+            $provider = new BoostServiceProvider(app());
+            $provider->register();
+            $provider->boot(app('router'));
+
+            expect(config('logging.channels.browser'))->toBeNull();
+        });
+
+        it('does not boot boost when debug is true', function () {
+            Config::set('boost.enabled', true);
+            Config::set('app.debug', true);
+            app()->detectEnvironment(fn () => 'testing');
+
+            $provider = new BoostServiceProvider(app());
+            $provider->register();
+            $provider->boot(app('router'));
+
+            expect(config('logging.channels.browser'))->toBeNull();
+        });
+    });
+});