web-development-guide git:20260924.6411787A

Immutable. This exact content never changes and is served at /api/v1/blob/aa954685c04f0191.

---
name: web-development-guide
description: Build a web app, configure TypeScript, Biome, Vitest, TypeDoc, pnpm or Turborepo, or debug web CI and hooks.
---

# Web Development Guide

## Project conventions

Read [references/project-rules.md](references/project-rules.md) for the relevant
section when handling this task. Read only what applies; examples do not
authorize releases, deployments or changes outside the user's scope.
Always-loaded safety rules still apply.

- Profile scope
- Read the vendored framework docs first
- Required package.json scripts
- TypeScript — extend the strict base
- Code quality — Biome
- Testing — Vitest
- Documentation (TSDoc + TypeDoc)
- Environment & secrets
- Security
- Accessibility
- Local Checks vs CI
- Git hooks & commits
- CI
- Monorepos — Turborepo