ADR 0006: Host MkDocs on Vercel
Context
Sprint 01 CI builds MkDocs with --strict. GitHub Pages cannot publish this private repository (HTTP 422). The owner already uses Vercel for other sites on team Jason's projects, and jasonkoch.io is already on that team.
Decision
Publish Inbox Agent docs from a new Vercel project, inbox-agent-docs, linked to PlatypusDBA/inbox-assistant.
- Production: https://duckbill.jasonkoch.io from
main - Preview: https://duckbill-dev.jasonkoch.io from
preview
Do not attach this repo to jasonkoch-io, platypus-software, assessly, or other existing Vercel projects.
Alternatives
- GitHub Pages — rejected; private-repo plan cannot enable Pages.
- Attach to an existing Vercel site — rejected; those projects serve other products.
- Manual artifact upload — rejected; Git integration keeps the site current with the repo.
Consequences
Docs update on Git push. MAIL-187 supersedes the MkDocs publisher: the same Vercel project now serves the Next.js app in apps/web (ADR 0007). Sign in with Apple is not part of this decision (MAIL-181). MAIL-206 renamed the GitHub repo to duckbill; see ADR 0013. The Vercel project slug stays inbox-agent-docs until MAIL-193.
