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.
Adopt explicit preview/staging/production tiers with immutable builds and environment-aware configuration to strengthen deployment credibility and operational safety.
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.
Completed implementation guide for Phase 1: Next.js app setup, CI/CD governance, Vercel deployment, and production promotion gating with comprehensive evidence artifacts.
Extended threat model covering deployment surface and runtime misconfiguration threats
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.
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.
Procedure to deploy the Portfolio Docs App via PR workflow, including validation steps and rollback triggers.
Procedures for promoting code from staging to production environments with validation gates and deployment checks.
Procedures for rolling back failed promotions and recovering from deployment issues across staging and production.
Detect deployment failures and execute rollback procedures
Step-by-step procedure to connect portfolio-app to Vercel, configure environment variables, set up GitHub Deployment Checks, and validate production promotion gating.