Deployment
Deploy the site and verify production-safe configuration.
Mental model
Deployment is standard Next.js hosting. Vercel is the default target. Build-time checks should pass before each deploy.
Do this
- Push repository to GitHub.
- Import the project in Vercel.
- Set
NEXT_PUBLIC_SITE_URLfor production. - Deploy.
Before pushing, run:
npm run lint
npm run test
npm run typecheck
npm run build
Verify
After deploy:
- Open the live site and check key pages (
/,/documentation,/graph). - Confirm canonical URLs use the production domain.
- Confirm link graph and WikiLinks navigation work.
Notes
CI workflow coverage includes lint, content route checks, typecheck, build, and high-severity audit.
See .github/workflows/ci.yml.