Microfrontends activation checklist (Phase 3)

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Preconditions

• microfrontends.json at repo root matches Vercel project names (encoreos-app, encoreos-public).
• npm run audit:microfrontends passes in CI and locally (strict keys; no unknown top-level fields).
• npm run audit:turbo-config passes (guards //# root tasks — bad microfrontends.json breaks turbo run).

​

Vercel (project owner)

• Vercel project encoreos-public created (Framework: Vite, root ., output dist, install npm ci --legacy-peer-deps).
• Microfrontends group created; default app = main project; encoreos-public added; fallback environment agreed.
• VERCEL_PROJECT_ID for both dev/prod public projects added to vite.config.ts → VERCEL_PROJECT_TO_SUPABASE (same Supabase target as sibling environment per runbook).

​

Wiring PR (engineer)

• npm install --save @vercel/microfrontends --legacy-peer-deps
• import { microfrontends } from '@vercel/microfrontends/experimental/vite' and register before lucidePreprocess() in vite.config.ts (see runbook).
• package.json scripts: mf:proxy, mf:port per runbook.
• PWA: disable vite-plugin-pwa for encoreos-public builds only (ADR-017 Option A).
• CI: MFE_DISABLE_LOCAL_PROXY_REWRITE=1 for E2E if required by runbook.

​

Verification

• npm run build succeeds for both project IDs (or both preview builds green).
• npm run mf:proxy + npm run dev — hit proxy URL; /, /auth, /portal/* smoke paths.
• Preview soak ≥ 24h; Speed Insights / Sentry reviewed (runbook step 4).

​

Rollback