Operational Deployment

Release flow and live route structure

This portal is built once and deployed with both apps under one host, using stable branch policy and route fallback rules for production reliability.

Live structure

/ multi-page portal
/3o/ Form 3 app
/4o/ Form 4 app

Build process

Root script builds both apps with base paths and assembles unified output in deploy/, including portal pages and static assets.

Production branch

Use official-deployment for Vercel production. Approved changes flow from main into official-deployment before release.

Vercel checklist

Production branch: official-deployment
Build command: npm run build
Output directory: deploy
Set env var: VITE_GROQ_API_KEY

Release checklist

Build passes in mathf3-o and mathf4-o
Portal links and pages render in both themes
Routes /3o/ and /4o/ verified
Cherry-pick or merge approved commit into deployment branch

See project structure