ADR-0003: Host Portfolio Docs App on Vercel with Preview Deployments
Decision to host the Docusaurus documentation site on Vercel, enabling PR preview deployments and main-branch production publishing.
Decision to host the Docusaurus documentation site on Vercel, enabling PR preview deployments and main-branch production publishing.
Decision to implement additional CI quality gates and Vercel deployment checks to enforce build determinism, code quality, and documentation integrity for the Documentation App.
Decision to deploy the Portfolio App to Vercel using preview deployments for PRs and production promotion gated by imported GitHub checks.
Deployment model for the Portfolio App: CI quality gates, Vercel environments, production promotion checks, and rollback posture.
Common Portfolio App failure modes and deterministic fixes: CI failures, routing issues, preview/prod drift, and evidence-link regressions.
Delivery model for the Portfolio Docs App: CI/CD contract, environments, hosting expectations, release discipline, and rollback posture.
Phase 1 completion of the Portfolio App including app skeleton, evidence-first UX, deterministic CI quality gates, Vercel deployment infrastructure, production promotion checks, and branch governance.
Procedure to deploy the Portfolio App with PR previews, staging validation, CI quality gates, and production promotion checks.
Step-by-step procedure to connect portfolio-app to Vercel, configure environment variables, set up GitHub Deployment Checks, and validate production promotion gating.