Merge branch 'main' into update_rector_rules

Author: pushpak1300

.ai/foundation.blade.php

@@ -27,7 +27,7 @@
 - Do not change the application's dependencies without approval.
 
 ## Frontend Bundling
-- If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `npm run build`, `npm run dev`, or `composer run dev`. Ask them.
+- If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `{{ $assist->nodePackageManager() }} run build`, `{{ $assist->nodePackageManager() }} run dev`, or `composer run dev`. Ask them.
 
 ## Replies
 - Be concise in your explanations - focus on what's important rather than explaining obvious details.

.ai/laravel/core.blade.php

@@ -39,4 +39,4 @@
 - When creating tests, make use of `php artisan make:test [options] <name>` to create a feature test, and pass `--unit` to create a unit test. Most tests should be feature tests.
 
 ### Vite Error
-- If you receive an "Illuminate\Foundation\ViteException: Unable to locate file in Vite manifest" error, you can run `npm run build` or ask the user to run `npm run dev` or `composer run dev`.
+- If you receive an "Illuminate\Foundation\ViteException: Unable to locate file in Vite manifest" error, you can run `{{ $assist->nodePackageManager() }} run build` or ask the user to run `{{ $assist->nodePackageManager() }} run dev` or `composer run dev`.

CHANGELOG.md

@@ -1,6 +1,20 @@
 # Release Notes
 
-## [Unreleased](https://github.com/laravel/boost/compare/v1.4.0...main)
+## [Unreleased](https://github.com/laravel/boost/compare/v1.5.0...main)
+
+## [v1.5.0](https://github.com/laravel/boost/compare/v1.4.0...v1.5.0) - 2025-10-24
+
+### What's Changed
+
+* Add PhpStorm detection path for Windows by [@GoneTone](https://github.com/GoneTone) in https://github.com/laravel/boost/pull/304
+* Dynamic NPM Package Runner by [@imliam](https://github.com/imliam) in https://github.com/laravel/boost/pull/145
+
+### New Contributors
+
+* [@GoneTone](https://github.com/GoneTone) made their first contribution in https://github.com/laravel/boost/pull/304
+* [@imliam](https://github.com/imliam) made their first contribution in https://github.com/laravel/boost/pull/145
+
+**Full Changelog**: https://github.com/laravel/boost/compare/v1.4.0...v1.5.0
 
 ## [v1.4.0](https://github.com/laravel/boost/compare/v1.3.3...v1.4.0) - 2025-10-14
 

src/BoostServiceProvider.php

@@ -36,6 +36,7 @@ public function register(): void
             $lockFiles = [
                 base_path('composer.lock'),
                 base_path('package-lock.json'),
+                base_path('bun.lock'),
                 base_path('bun.lockb'),
                 base_path('pnpm-lock.yaml'),
                 base_path('yarn.lock'),

src/Install/GuidelineAssist.php

@@ -6,6 +6,7 @@
 
 use Illuminate\Database\Eloquent\Model;
 use Laravel\Boost\Install\Assists\Inertia;
+use Laravel\Roster\Enums\NodePackageManager;
 use Laravel\Roster\Enums\Packages;
 use Laravel\Roster\Roster;
 use ReflectionClass;
@@ -168,4 +169,9 @@ public function inertia(): Inertia
     {
         return new Inertia($this->roster);
     }
+
+    public function nodePackageManager(): string
+    {
+        return ($this->roster->nodePackageManager() ?? NodePackageManager::NPM)->value;
+    }
 }

tests/Feature/Install/GuidelineComposerTest.php

@@ -5,13 +5,19 @@
 use Laravel\Boost\Install\GuidelineComposer;
 use Laravel\Boost\Install\GuidelineConfig;
 use Laravel\Boost\Install\Herd;
+use Laravel\Roster\Enums\NodePackageManager;
 use Laravel\Roster\Enums\Packages;
 use Laravel\Roster\Package;
 use Laravel\Roster\PackageCollection;
 use Laravel\Roster\Roster;
 
 beforeEach(function (): void {
     $this->roster = Mockery::mock(Roster::class);
+    $this->nodePackageManager = NodePackageManager::NPM;
+    $this->roster->shouldReceive('nodePackageManager')->andReturnUsing(
+        fn (): NodePackageManager => $this->nodePackageManager
+    );
+
     $this->herd = Mockery::mock(Herd::class);
     $this->herd->shouldReceive('isInstalled')->andReturn(false)->byDefault();
 
@@ -357,3 +363,22 @@
         ->toContain('=== phpunit/core rules ===')
         ->not->toContain('=== pest/core rules ===');
 });
+
+test('includes correct package manager commands in guidelines based on lockfile', function (NodePackageManager $packageManager, string $expectedCommand): void {
+    $packages = new PackageCollection([
+        new Package(Packages::LARAVEL, 'laravel/framework', '11.0.0'),
+    ]);
+    $this->nodePackageManager = $packageManager;
+    $this->roster->shouldReceive('packages')->andReturn($packages);
+
+    $guidelines = $this->composer->compose();
+
+    expect($guidelines)
+        ->toContain("{$expectedCommand} run build")
+        ->toContain("{$expectedCommand} run dev");
+})->with([
+    'npm' => [NodePackageManager::NPM, 'npm'],
+    'pnpm' => [NodePackageManager::PNPM, 'pnpm'],
+    'yarn' => [NodePackageManager::YARN, 'yarn'],
+    'bun' => [NodePackageManager::BUN, 'bun'],
+]);