react-redux-boilerplate AGENTS.md

AGENTS.md

Project overview

Production-ready React 19 boilerplate using vertical slice architecture. The stack is React 19 + Redux Toolkit 2 + Vite 7 + TypeScript 5.9 + Tailwind CSS 4 + Biome.

Setup commands

• Node version: 24.x (defined in .nvmrc). Use fnm use or nvm use before running commands.
• Package manager: pnpm 10.x (corepack enable if needed).
• Install deps: pnpm install
• Create env: pnpm create:env
• Dev server: pnpm dev (starts at http://localhost:5173)
• Build: pnpm build (runs tsc -b && vite build)

Testing

• Unit/integration tests: pnpm test (Vitest 4 + Testing Library + jsdom)
• With coverage: pnpm test:coverage
• E2E tests: pnpm e2e:local (requires dev server running in another terminal)
• E2E uses: Cucumber + Playwright. Install browsers first: pnpm exec playwright install
• Test files live next to the code they test with .spec.ts / .spec.tsx suffix.
• Mock data files use .mocks.spec.ts suffix and are excluded from test runs.
• MSW (Mock Service Worker) handles API mocking in both tests and development.
• Vitest globals (describe, it, expect, vi) are available without imports.
• Always run pnpm test and pnpm build before submitting changes.

Linting, formatting, and type checking

• Single tool: Biome handles both linting and formatting. No ESLint or Prettier.
• Check all: pnpm check (runs biome check && tsc --noEmit)
• Auto-fix: pnpm check:fix (runs biome check --write && tsc --noEmit)
• Format only: pnpm format
• Lint only: pnpm lint
• Type check only: pnpm type:check
• Pre-commit hook (Husky) runs pnpm biome check --staged and pnpm test automatically.

Code style

• TypeScript strict mode with noImplicitAny: false.
• Single quotes, semicolons, trailing commas, 2-space indent, LF line endings, 80 char line width.
• Use import type for type-only imports (enforced by Biome useImportType).
• Prefer for...of over .forEach() (enforced by Biome noForEach).
• Use const over let when possible. Never use var.
• Use unknown instead of any for error catches and untyped values.
• Use import.meta.env instead of process.env in browser/Vite code.
• Use null (not undefined) as the return value for components that render nothing.
• Absolute imports via @/ alias (maps to src/). Never use relative imports that go above the current feature.