This project uses a collection of custom scripts to automate common tasks, enforce quality standards, and enhance the build process.
| Command | Description |
|---|
dev | Start development server |
dev:host | Start development server with network access |
dev:debug | Start development server with verbose logging |
preview | Preview production build locally |
clean | Remove build artifacts (dist, .astro) |
clean:all | Remove build artifacts and node_modules cache |
| Command | Description |
|---|
build | Build tokens then build site for production |
build:ci | Build for CI with verbose logging |
tokens:build | Compile design tokens to CSS variables (tokens/dist/tokens.css) and tailwind-tokens.json |
| Command | Description |
|---|
format | Format code with Biome |
format:check | Check code formatting without changes |
lint | Lint code with Biome |
lint:md | Lint Markdown files |
lint:md:fix | Fix Markdown linting issues |
check | Run Astro type checking (astro check) |
check:types | Run TypeScript type checking only (tsc --noEmit) |
quality | Run all quality checks (format, lint, markdown, types) |
quality:ci | The full CI quality gate: format:check + lint + lint:md + check + test:unit + agents:check + version:check + og:check + docs:count |
| Command | Description |
|---|
test | Run unit tests with Vitest |
test:unit | Run unit tests once |
test:mutate | Run Stryker mutation testing against the unit suite |
test:e2e | Run Playwright end-to-end tests |
test:e2e:ui | Run E2E tests with UI |
test:a11y | Run accessibility tests |
| Command | Description |
|---|
docs:count | Verify documented counts (ADRs, components, etc.) match the filesystem (CI gate) |
roadmap:update | Update implementation roadmap status |
Documentation syncing is handled from the docs-site repository (its update:adrs and update:versions scripts), not from this project.
| Command | Description |
|---|
images:analyze | Analyze image sizes and optimization opportunities |
images:gate | Enforce the per-image size budget (CI gate) |
images:optimize | Interactive image optimization tool |
fonts:gate | Enforce the font-preload cap (CI gate) |
bundle:analyze | Analyze bundle size and composition |
perf:budgets | Check performance against defined budgets |
perf:baseline | Track baseline performance metrics |
perf:lighthouse | Run Lighthouse performance audit |
perf:lighthouse:ci | Run Lighthouse for CI (JSON output) |
perf:lhci | Run Lighthouse CI (lhci autorun) |
| Command | Description |
|---|
design:validate | Validate color contrast compliance (WCAG AA) |
budgets:validate | Validate performance budget overrides |
| Command | Description |
|---|
audit | Run security audit on production dependencies |
audit:ci | Run filtered security audit for CI |
| Command | Description |
|---|
prepare | Install Husky git hooks |
