> ## 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.

# Microfrontends activation checklist (Phase 3)

> Status: Pre-activation reference Canonical runbook: MICROFRONTENDS_RUNBOOK.md PWA: ADR-017

**Status:** Pre-activation reference\
**Canonical runbook:** [MICROFRONTENDS\_RUNBOOK.md](./MICROFRONTENDS_RUNBOOK.md)\
**PWA:** [ADR-017](../architecture/decisions/ADR-017-microfrontends-pwa-scoping.md)

Use this checklist immediately before and after owner-side Vercel steps. Do not treat `microfrontends.json` as documentation — keep narrative notes in this file or the runbook.

## 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

Instant rollback on default app deployment; delete microfrontends group to restore single-app routing. See runbook “Rollback plan”.