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.
Governance for CI/CD and environment promotion features.
CI/CD pipelines, environments, deployment strategies, artifact management, and observability practices that demonstrate production-grade operational maturity.
Automatic PR preview environments for validation.
Required checks and deployment checks before production.
Git revert based rollback for production issues.
Manual staging validation before production promotion.
Step-by-step guide to configure GitHub branch protection rulesets for portfolio-app main branch, enforcing CI checks and PR reviews.
Deployment model for the Portfolio App: CI quality gates, Vercel environments, production promotion checks, and rollback posture.
Delivery model for the Portfolio Docs App: CI/CD contract, environments, hosting expectations, release discipline, and rollback posture.
Procedure to deploy the Portfolio App with PR previews, staging validation, CI quality gates, and production promotion checks.
Deterministic procedure for diagnosing and fixing Portfolio App CI failures: lint, format checks, typecheck, and build failures.
Step-by-step procedure to connect portfolio-app to Vercel, configure environment variables, set up GitHub Deployment Checks, and validate production promotion gating.