Local Development

The repository uses pnpm workspaces and Turborepo to coordinate applications and shared packages.

mise provides the Node.js and pnpm toolchain.

Start the entire repository

pnpm dev

Current development services:

web        http://localhost:3000
docs       http://localhost:3001
Storybook  http://localhost:6006

Web application:

pnpm --filter web dev

Documentation:

pnpm --filter docs dev

Storybook:

pnpm --filter @repo/ui dev

Once the repository toolchain has been installed, normal development uses pnpm directly.

pnpm dev
pnpm format
pnpm lint
pnpm check-types
pnpm test
pnpm build

For one complete validation pass:

pnpm verify

mise does not replace these commands.

Use mise when bootstrapping or updating the project toolchain:

mise install --locked

Add an application dependency to the workspace that owns it.

Web:

pnpm --filter web add <package>

Documentation:

pnpm --filter docs add <package>

UI package:

pnpm --filter @repo/ui add <package>

Add a development dependency:

pnpm --filter web add -D <package>

Add a repository-level development tool:

pnpm add -Dw <package>

Remove a dependency from a workspace:

pnpm --filter web remove <package>

Do not manually edit pnpm-lock.yaml.

Before pushing substantial changes, run:

pnpm verify
git diff --check

The repository contracts mean that UI validation does not require separate Storybook-specific commands.

For targeted UI work, the corresponding workspace commands remain available:

pnpm --filter @repo/ui test
pnpm --filter @repo/ui build-storybook

Git hooks provide additional local validation.

GitHub Actions independently reproduces the critical quality gates remotely.