chore: switch from Bun to pnpm

- Replace Bun with pnpm in GitHub workflows (lint & tests)
- Update composer.json scripts to use pnpm commands
- Add @css alias to vite.config.ts and tsconfig.json
- Update .oxlintrc.json to ignore generated type files
- Fix app.ts import to use @css alias
- Add new index.vue page
- Update CLAUDE.md and README.md documentation
- Remove bun.lock, add pnpm-lock.yaml
- Move auto-imports.d.ts and components.d.ts to resources/js/types/

Author: imsus

.github/workflows/lint.yml

@@ -24,15 +24,21 @@ jobs:
         with:
           php-version: "8.4"
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
         with:
-          bun-version: "latest"
+          version: "latest"
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "latest"
+          cache: "pnpm"
 
       - name: Install Dependencies
         run: |
           composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
-          bun i
+          pnpm install
 
       - name: Setup Mago
         uses: nhedger/setup-mago@v1
@@ -44,7 +50,7 @@ jobs:
           composer analyze --reporting-format=github
 
       - name: Lint & Format Frontend
-        run: bun run lint && bun run format
+        run: pnpm run lint && pnpm run format
 
       # - name: Commit Changes
       #   uses: stefanzweifel/git-auto-commit-action@v5

.github/workflows/tests.yml

@@ -32,14 +32,15 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: "22"
+          cache: "pnpm"
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
         with:
-          bun-version: "latest"
+          version: "latest"
 
       - name: Install Node Dependencies
-        run: bun i
+        run: pnpm install
 
       - name: Install Dependencies
         run: composer install --no-interaction --prefer-dist --optimize-autoloader
@@ -51,7 +52,7 @@ jobs:
         run: php artisan key:generate
 
       - name: Build Assets
-        run: bun run build
+        run: pnpm run build
 
       - name: Tests
         run: ./vendor/bin/pest

.oxlintrc.json

@@ -5,8 +5,16 @@
     "./node_modules/ultracite/config/oxlint/vue/.oxlintrc.json"
   ],
   "ignorePatterns": [
-    "resources/js/auto-imports.d.ts",
-    "resources/js/components.d.ts"
+    "resources/js/types/auto-imports.d.ts",
+    "resources/js/types/components.d.ts",
+    "vite.config.ts",
+    "postcss.config.js",
+    "tailwind.config.js",
+    "tailwind.config.ts",
+    "tsconfig.json",
+    "tsconfig.*.json",
+    "*.config.js",
+    "*.config.ts"
   ],
   "rules": {
     "eslint-plugin-unicorn/filename-case": "off",

CLAUDE.md

@@ -9,27 +9,29 @@ The Laravel Boost guidelines are specifically curated by Laravel maintainers for
 
 This application is a Laravel application and its main Laravel ecosystems package & versions are below. You are an expert with them all. Ensure you abide by these specific packages & versions.
 
-- php - 8.4.17
-- inertiajs/inertia-laravel (INERTIA) - v2
+- php - 8.5.4
+- inertiajs/inertia-laravel (INERTIA_LARAVEL) - v2
 - laravel/framework (LARAVEL) - v12
 - laravel/prompts (PROMPTS) - v0
 - laravel/wayfinder (WAYFINDER) - v0
+- laravel/boost (BOOST) - v2
 - laravel/mcp (MCP) - v0
+- laravel/pail (PAIL) - v1
 - laravel/pint (PINT) - v1
 - laravel/sail (SAIL) - v1
 - pestphp/pest (PEST) - v4
 - phpunit/phpunit (PHPUNIT) - v12
-- @inertiajs/vue3 (INERTIA) - v2
+- @inertiajs/vue3 (INERTIA_VUE) - v2
 - vue (VUE) - v3
-- @laravel/vite-plugin-wayfinder (WAYFINDER) - v0
+- @laravel/vite-plugin-wayfinder (WAYFINDER_VITE) - v0
 
 ## Skills Activation
 
 This project has domain-specific skills available. You MUST activate the relevant skill whenever you work in that domain—don't wait until you're stuck.
 
 - `wayfinder-development` — Activates whenever referencing backend routes in frontend components. Use when importing from @/actions or @/routes, calling Laravel routes from TypeScript, or working with Wayfinder route functions.
 - `pest-testing` — Tests applications using the Pest 4 PHP framework. Activates when writing tests, creating unit or feature tests, adding assertions, testing Livewire components, browser testing, debugging test failures, working with datasets or mocking; or when the user mentions test, spec, TDD, expects, assertion, coverage, or needs to verify functionality works.
-- `inertia-vue-development` — Develops Inertia.js v2 Vue client-side applications. Activates when creating Vue pages, forms, or navigation; using <Link>, <Form>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions Vue with Inertia, Vue pages, Vue forms, or Vue navigation.
+- `inertia-vue-development` — Develops Inertia.js v2 Vue client-side applications. Activates when creating Vue pages, forms, or navigation; using <Link>, <Form>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions Vue with Inertia, Vue pages, Vue forms, or Vue navigation.
 
 ## Conventions
 
@@ -48,7 +50,7 @@ This project has domain-specific skills available. You MUST activate the relevan
 
 ## Frontend Bundling
 
-- If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `bun run build`, `bun 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 `pnpm run build`, `pnpm run dev`, or `composer run dev`. Ask them.
 
 ## Documentation Files
 
@@ -64,18 +66,23 @@ This project has domain-specific skills available. You MUST activate the relevan
 
 - Laravel Boost is an MCP server that comes with powerful tools designed specifically for this application. Use them.
 
-## Artisan
+## Artisan Commands
 
-- Use the `list-artisan-commands` tool when you need to call an Artisan command to double-check the available parameters.
+- Run Artisan commands directly via the command line (e.g., `php artisan route:list`, `php artisan tinker --execute "..."`).
+- Use `php artisan list` to discover available commands and `php artisan [command] --help` to check parameters.
 
 ## URLs
 
 - Whenever you share a project URL with the user, you should use the `get-absolute-url` tool to ensure you're using the correct scheme, domain/IP, and port.
 
-## Tinker / Debugging
+## Debugging
 
-- You should use the `tinker` tool when you need to execute PHP to debug code or query Eloquent models directly.
 - Use the `database-query` tool when you only need to read from the database.
+- Use the `database-schema` tool to inspect table structure before writing migrations or models.
+- To execute PHP code for debugging, run `php artisan tinker --execute "your code here"` directly.
+- To read configuration values, read the config files directly or run `php artisan config:show [key]`.
+- To inspect routes, run `php artisan route:list` directly.
+- To check environment variables, read the `.env` file directly.
 
 ## Reading Browser Logs With the `browser-logs` Tool
 
@@ -106,20 +113,22 @@ This project has domain-specific skills available. You MUST activate the relevan
 ## Constructors
 
 - Use PHP 8 constructor property promotion in `__construct()`.
-  - <code-snippet>public function \_\_construct(public GitHub $github) { }</code-snippet>
+  - `public function __construct(public GitHub $github) { }`
 - Do not allow empty `__construct()` methods with zero parameters unless the constructor is private.
 
 ## Type Declarations
 
 - Always use explicit return type declarations for methods and functions.
 - Use appropriate PHP type hints for method parameters.
 
-<code-snippet name="Explicit Return Types and Method Params" lang="php">
+<!-- Explicit Return Types and Method Params -->
+
+```php
 protected function isAccessible(User $user, ?string $path = null): bool
 {
     ...
 }
-</code-snippet>
+```
 
 ## Enums
 
@@ -138,23 +147,21 @@ protected function isAccessible(User $user, ?string $path = null): bool
 # Inertia
 
 - Inertia creates fully client-side rendered SPAs without modern SPA complexity, leveraging existing server-side patterns.
-- Components live in `resources/js/Pages` (unless specified in `vite.config.js`). Use `Inertia::render()` for server-side routing instead of Blade views.
+- Components live in `resources/js/pages` (unless specified in `vite.config.js`). Use `Inertia::render()` for server-side routing instead of Blade views.
 - ALWAYS use `search-docs` tool for version-specific Inertia documentation and updated code examples.
 - IMPORTANT: Activate `inertia-vue-development` when working with Inertia Vue client-side patterns.
 
-=== inertia-laravel/v2 rules ===
-
 # Inertia v2
 
 - Use all Inertia features from v1 and v2. Check the documentation before making changes to ensure the correct approach.
-- New features: deferred props, infinite scrolling (merging props + `WhenVisible`), lazy loading on scroll, polling, prefetching.
+- New features: deferred props, infinite scroll, merging props, polling, prefetching, once props, flash data.
 - When using deferred props, add an empty state with a pulsing or animated skeleton.
 
 === laravel/core rules ===
 
 # Do Things the Laravel Way
 
-- Use `php artisan make:` commands to create new files (i.e. migrations, controllers, models, etc.). You can list available Artisan commands using the `list-artisan-commands` tool.
+- Use `php artisan make:` commands to create new files (i.e. migrations, controllers, models, etc.). You can list available Artisan commands using `php artisan list` and check their parameters with `php artisan [command] --help`.
 - If you're creating a generic PHP class, use `php artisan make:class`.
 - Pass `--no-interaction` to all Artisan commands to ensure they work without user input. You should also pass the correct `--options` to ensure correct behavior.
 
@@ -168,7 +175,7 @@ protected function isAccessible(User $user, ?string $path = null): bool
 
 ### Model Creation
 
-- When creating new models, create useful factories and seeders for them too. Ask the user if they need any other things, using `list-artisan-commands` to check the available options to `php artisan make:model`.
+- When creating new models, create useful factories and seeders for them too. Ask the user if they need any other things, using `php artisan make:model --help` to check the available options.
 
 ### APIs & Eloquent Resources
 
@@ -203,7 +210,7 @@ protected function isAccessible(User $user, ?string $path = null): bool
 
 ## Vite Error
 
-- If you receive an "Illuminate\Foundation\ViteException: Unable to locate file in Vite manifest" error, you can run `bun run build` or ask the user to run `bun run dev` or `composer run dev`.
+- If you receive an "Illuminate\Foundation\ViteException: Unable to locate file in Vite manifest" error, you can run `pnpm run build` or ask the user to run `pnpm run dev` or `composer run dev`.
 
 === laravel/v12 rules ===
 
@@ -246,8 +253,8 @@ Wayfinder generates TypeScript functions for Laravel routes. Import from `@/acti
 
 # Laravel Pint Code Formatter
 
-- You must run `vendor/bin/pint --dirty` before finalizing changes to ensure your code matches the project's expected style.
-- Do not run `vendor/bin/pint --test`, simply run `vendor/bin/pint` to fix any formatting issues.
+- If you have modified any PHP files, you must run `vendor/bin/pint --dirty --format agent` before finalizing changes to ensure your code matches the project's expected style.
+- Do not run `vendor/bin/pint --test --format agent`, simply run `vendor/bin/pint --format agent` to fix any formatting issues.
 
 === pest/core rules ===
 
@@ -266,4 +273,5 @@ Wayfinder generates TypeScript functions for Laravel routes. Import from `@/acti
 Vue components must have a single root element.
 
 - IMPORTANT: Activate `inertia-vue-development` when working with Inertia Vue client-side patterns.
-  </laravel-boost-guidelines>
+
+</laravel-boost-guidelines>

README.md

@@ -5,7 +5,7 @@ A modern Laravel starter kit with Inertia, Vue 3, and an enhanced developer expe
 ## Tech Stack
 
 - **PHP** 8.4+ with Laravel 12
-- **Runtime**: Bun
+- **Runtime**: pnpm
 - **Frontend**: Vue 3 with Inertia v2
 - **Styling**: Tailwind CSS 4
 - **State Management**: VueUse
@@ -73,7 +73,7 @@ const post = show(1); // { url: "/posts/1", method: "get" }
 ### Prerequisites
 
 - PHP 8.4+
-- Bun
+- pnpm
 - Composer
 
 ### Installation
@@ -83,24 +83,24 @@ const post = show(1); // { url: "/posts/1", method: "get" }
 composer install
 
 # Install JavaScript dependencies
-bun install
+pnpm install
 
 # Start development servers
-bun run dev
+pnpm run dev
 ```
 
 ### Available Commands
 
-| Command             | Description                  |
-| ------------------- | ---------------------------- |
-| `bun run dev`       | Start Vite dev server        |
-| `bun run build`     | Build for production         |
-| `bun run build:ssr` | Build for SSR                |
-| `bun run format`    | Format JS/TS/Vue (ultracite) |
-| `bun run lint`      | Lint JS/TS/Vue (ultracite)   |
-| `composer lint`     | Lint PHP (mago)              |
-| `composer format`   | Format PHP (mago)            |
-| `php artisan test`  | Run Pest tests               |
+| Command              | Description                  |
+| -------------------- | ---------------------------- |
+| `pnpm run dev`       | Start Vite dev server        |
+| `pnpm run build`     | Build for production         |
+| `pnpm run build:ssr` | Build for SSR                |
+| `pnpm run format`    | Format JS/TS/Vue (ultracite) |
+| `pnpm run lint`      | Lint JS/TS/Vue (ultracite)   |
+| `composer lint`      | Lint PHP (mago)              |
+| `composer format`    | Format PHP (mago)            |
+| `php artisan test`   | Run Pest tests               |
 
 ## Project Structure
 

app/Http/Controllers/Controller.php

@@ -1,6 +1,6 @@
 <?php
 
-declare(strict_types = 1);
+declare(strict_types=1);
 
 namespace App\Http\Controllers;
 

app/Http/Middleware/HandleInertiaRequests.php

@@ -1,6 +1,6 @@
 <?php
 
-declare(strict_types = 1);
+declare(strict_types=1);
 
 namespace App\Http\Middleware;
 

app/Models/User.php

@@ -1,6 +1,6 @@
 <?php
 
-declare(strict_types = 1);
+declare(strict_types=1);
 
 namespace App\Models;
 

app/Providers/AppServiceProvider.php

@@ -1,6 +1,6 @@
 <?php
 
-declare(strict_types = 1);
+declare(strict_types=1);
 
 namespace App\Providers;
 
@@ -18,9 +18,7 @@ class AppServiceProvider extends ServiceProvider
     /**
      * Register any application services.
      */
-    public function register(): void
-    {
-    }
+    public function register(): void {}
 
     /**
      * Bootstrap any application services.