Project Bootstrap — Company Tooling Standards

Apply the Socially-Free standard toolchain to a Laravel + Inertia + React project.

Quick Start

1. Bun — Delete package-lock.json, run bun install. Update CI workflows to use oven-sh/setup-bun@v2 and bun install / bun run <script>.
2. Biome — Replace ESLint deps with @biomejs/biome: "2.4.13". Copy references/biome.json into the project. Update package.json scripts (lint, lint:check, format:check). Delete eslint.config.js. Keep Prettier with its plugins — the existing .prettierrc (Tailwind class ordering + import organization) stays; Biome does not offer Tailwind class sorting. Run bun install.
3. Composer scripts — Replace the starter kit's scripts section with references/composer-scripts.json. Keep the starter kit's post-autoload-dump, post-update-cmd, post-root-package-install scripts intact — only replace the user-facing ones. Ensure test:lint (pint --parallel --test) and lint (pint --parallel) exist.
4. Laravel Wayfinder — The generate:routing composer script relies on php artisan wayfinder:generate. Install the Laravel Wayfinder package so this command is available. Follow the Laravel Wayfinder installation instructions for your project.
5. CI workflows — Copy references/lint.yml and references/tests.yml into .github/workflows/. The lint workflow uses check-only commands (pint --test, biome ci) so it FAILS on formatting drift instead of silently fixing and discarding it.
6. Formatting enforcement (hooks) — Add husky + lint-staged (merge references/package-json.snippets.json into package.json, copy references/pre-commit into .husky/pre-commit), run bun install to wire the hooks. Pre-commit runs pint / biome --write / prettier --write on staged files only — Biome first, Prettier last, so Prettier owns the final on-disk state (CSS quote style, import order, Tailwind class order).
7. .gitignore — Ensure bun.lock is tracked (not gitignored).

Run bun run build, composer fix, and git commit (to confirm the pre-commit hook fires) to verify.

Verification