42 lines (35 loc) · 915 Bytes

RUNBOOK.md

Local setup

Install dependencies
Run development server
Run lint, typecheck, test, build

Expected scripts

npm run dev
npm run lint
npm run typecheck
npm run test
npm run build

Deployment target

Preferred:

Vercel or Netlify

Environment variables

Only add if absolutely necessary. If a contact form provider is used, store secrets in environment variables and never expose them client-side.

Build checklist

homepage renders correctly
all routes accessible
metadata present
MDX content loads
no console errors
tests pass
build passes

Post-deploy checklist

verify production routes
verify OG/meta tags
verify sitemap
verify robots
verify mobile nav
verify project/article detail pages
verify email/contact path

Rollback principle

If a change risks breaking production, revert to last known good state and isolate the regression.