vivreal-portal-knowledge

Use when working in the Vivreal Portal (Vivreal_Portal_Mobile), a Next.js 16 App Router web app despite the "Mobile" name. Covers the proxy-route layer (createProxyHandler factory vs hand-written), the three-tier API client rule (createAuthAxios / publicAxios / fetch), the four backend upstreams, auth cookies (token + active_ctx), the retired in-app agent (AI is MCP only), feature flags, PWA shell traps, offline honesty, the Socials and Channels screens, SSR-safe patterns, and e2e/unit test gates. Triggers on: portal, Vivreal_Portal_Mobile, proxy route, createAuthAxios, createProxyHandler, active_ctx, AuthContext, edge runtime, basePath /app, site analytics dashboard, social hub, AI FAB, agent drawer, EditPlan, feature flags, Instagram inbox, reach-out console (formerly cold-call), demo-account claim flow, site template picker, Studio editor, dashboard insights, account deletion, e2e testing, coverage map. Source of truth: Vivreal_Portal_Mobile CLAUDE.md at origin/stable (recount src/app/api/proxy/).