Tooling how-tos

Practical guides for the quality and docs stack in a Next.js brochure monorepo: install, day-to-day commands, and implementation examples.

Guide	Install focus	Implement focus
ESLint	eslint + Next + Prettier configs	Flat rules, fix workflow
Prettier	prettier, ignore file	Format scripts + agent hooks
TypeScript	typescript, tsconfig	Strict types, path alias
Fallow	fallow package	Dead-code check, audit gate
Vitest	vitest	Colocated unit tests
Playwright	@playwright/test + browsers	Specs, codegen, API mocks
VitePress	vitepress	Dual docs trees, nav
Mermaid	mermaid + plugin	Diagrams in Markdown
Vercel	vercel CLI / dashboard	App + public-docs projects

First-time machine setup

# Node ≥ 20, pnpm ≥ 10
pnpm install
pnpm run test:e2e:install            # Playwright Chromium (once)
pnpm run fallow:type-aware-status    # optional Fallow companion check

Day-to-day quality gate:

pnpm run check          # format:check + lint + typecheck
pnpm run check:unit     # check + Vitest
pnpm run post-agent     # format write + lint + typecheck + unit tests