@mr.dj2u/library-registry 0.2.0 → 0.3.0

package/dist/catalog.js

@@ -165,6 +165,7 @@ const mdsItems = [
         assets: [
             mdsAsset("src/theme/tokens.ts", "src/theme/tokens.ts", "support"),
             mdsAsset("src/theme/provider.tsx", "src/theme/provider.tsx", "support"),
+            mdsAsset("src/theme/color-utils.ts", "src/theme/color-utils.ts", "support"),
             mdsAsset("src/theme/font-assets.ts", "src/theme/font-assets.ts", "support"),
         ],
         integration: {
@@ -293,7 +294,7 @@ const mdsItems = [
     defineItem({
         id: "mds/legal-documents",
         name: "Legal documents",
-        description: "Reusable terms and privacy content with public routes, modal review, settings links, and onboarding agreement surfaces.",
+        description: "Reusable terms and privacy content with public routes, modal review, settings links, onboarding agreement, and material update gate surfaces.",
         kind: "flow",
         tags: [
             "legal",
@@ -302,11 +303,16 @@ const mdsItems = [
             "agreements",
             "content-pages",
             "onboarding",
+            "legal-update-gate",
+            "protected-routes",
         ],
         categories: ["legal", "content", "onboarding"],
         compatibility: { ...SDK_56, platforms: ALL_PLATFORMS },
+        dependencies: [
+            runtime("react-native-safe-area-context", "~5.7.0", "expo"),
+        ],
         composedItems: ["mds/theme-support"],
-        relatedItems: ["mds/onboarding-preview", "mds/settings"],
+        relatedItems: ["mds/onboarding", "mds/onboarding-state", "mds/settings"],
         variants: [
             {
                 id: "public-routes",
@@ -360,24 +366,52 @@ const mdsItems = [
                     "Ask where the app should expose legal links, then render LegalDocumentLinks from the copied feature file in that settings or app-info surface.",
                 ],
             },
+            {
+                id: "legal-update-gate",
+                name: "Material update gate",
+                description: "Adds /legal/updates for required legal re-acceptance before protected app content opens.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [runtime("expo-router", "~56.2.6", "expo")],
+                assets: [
+                    mdsAsset("src/app/terms.tsx", "{{appDir}}/terms.tsx", "route"),
+                    mdsAsset("src/app/privacy.tsx", "{{appDir}}/privacy.tsx", "route"),
+                    mdsAsset("src/app/legal/updates.tsx", "{{appDir}}/legal/updates.tsx", "route"),
+                    mdsAsset("src/features/legal/legal-update-screen.tsx", "{{featuresDir}}/legal/legal-update-screen.tsx"),
+                ],
+                integration: [
+                    "Keep /terms, /privacy, and /legal/updates public, then wrap app routes in Stack.Protected or Tabs.Protected with a guard that includes legalGateStatus === \"complete\".",
+                    "Replace the default memory legal adapter with mds/onboarding-state before hosted production use. Supabase user acceptance rows are the production path.",
+                    "Mark only material legal updates with requiresReacceptance: true; minor copy edits can update public documents without blocking app entry.",
+                ],
+            },
         ],
         assets: [
-            mdsAsset("src/features/legal/legal-documents.ts", "{{featuresDir}}/legal/legal-documents.ts", "support", ["__MDS_APP_NAME__"]),
+            mdsAsset("src/features/legal/legal-documents.ts", "{{featuresDir}}/legal/legal-documents.ts", "support", [
+                "__MDS_APP_NAME__",
+                "__MDS_LEGAL_BUSINESS_NAME__",
+                "__MDS_LEGAL_CONTACT_EMAIL__",
+                "__MDS_LEGAL_ADDRESS_OR_REGION_NOTE__",
+            ]),
             mdsAsset("src/features/legal/legal-document-view.tsx", "{{featuresDir}}/legal/legal-document-view.tsx"),
             mdsAsset("src/features/legal/legal-page-route.tsx", "{{featuresDir}}/legal/legal-page-route.tsx"),
             mdsAsset("src/features/legal/legal-document-modal.tsx", "{{featuresDir}}/legal/legal-document-modal.tsx"),
             mdsAsset("src/features/legal/use-legal-acceptance.ts", "{{featuresDir}}/legal/use-legal-acceptance.ts", "support"),
+            mdsAsset("src/features/legal/legal-acceptance-config.ts", "{{featuresDir}}/legal/legal-acceptance-config.ts", "support"),
+            mdsAsset("src/features/legal/legal-acceptance-adapter.ts", "{{featuresDir}}/legal/legal-acceptance-adapter.ts", "support"),
         ],
         integration: {
             summary: "Copy the shared legal content source and render it through routes, modal review, settings links, or onboarding agreement surfaces.",
             instructions: [
                 "Replace every placeholder legal section with documents reviewed for the app, jurisdiction, data practices, and business model.",
                 "Keep the terms and privacy content in the shared legal-documents source so public routes, modals, settings links, and onboarding review show the same copy.",
+                "Use the legal-update-gate variant when an authenticated app must block protected routes until current material document versions are accepted.",
                 "If the app already has brand or theme colors, map the copied src/theme/tokens.ts palette to the app's existing light and dark colors, or pass color overrides into AppThemeProvider.",
             ],
             notes: [
                 "The bundled placeholder copy is not legal advice and must be reviewed before production.",
-                "The local acceptance hook is intentionally lightweight; replace or adapt it when onboarding needs persistence or backend audit records.",
+                "The default legal adapter is memory-only and is not a hosted audit record.",
+                "Use mds/onboarding-state or mds/onboarding-auth-supabase to persist completion and versioned legal acceptance.",
+                "Hosted apps should configure user-scoped Supabase persistence and write legal acceptance after sign-in.",
                 "AppThemeProvider follows the system color scheme by default; pass scheme=\"light\", scheme=\"dark\", or scheme=\"preview\" when a screen needs a fixed theme.",
             ],
         },
@@ -386,45 +420,399 @@ const mdsItems = [
         },
     }),
     defineItem({
-        id: "mds/onboarding-preview",
-        name: "Onboarding preview flow",
-        description: "The current MDS legal-consent onboarding preview and explicit handoff to a future real account flow.",
+        id: "mds/auth",
+        name: "Auth flow",
+        description: "Provider-neutral authentication routes, refreshable session adapters, a reusable guard, and backend-specific variants.",
         kind: "flow",
-        tags: ["onboarding", "legal", "preview", "eject:onboarding"],
-        categories: ["onboarding", "flows"],
+        tags: [
+            "auth",
+            "session",
+            "sign-in",
+            "sign-up",
+            "protected-routes",
+            "eject:auth",
+        ],
+        categories: ["auth", "flows", "onboarding"],
         compatibility: SDK_56_ROUTER,
         dependencies: [runtime("expo-router", "~56.2.6", "expo")],
-        relatedItems: ["mds/settings"],
+        composedItems: ["mds/theme-support"],
+        relatedItems: ["mds/onboarding", "mds/onboarding-state", "mds/legal-documents", "mds/settings"],
+        variants: [
+            {
+                id: "base",
+                name: "Base auth adapter",
+                description: "Adds a provider-neutral auth shell with an in-memory adapter for custom provider work.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                assets: [
+                    mdsAsset("src/features/auth/adapters/base-auth-adapter.tsx", "{{featuresDir}}/auth/auth-adapter.tsx", "support"),
+                    mdsAsset("project/auth-base.md", "project/auth.md", "support"),
+                ],
+                integration: [
+                    "Replace the base auth adapter with a real provider before production.",
+                    "Wrap the app's root route layout in AuthProvider before using useAuth or protected auth screens.",
+                ],
+            },
+            {
+                id: "with-supabase",
+                name: "With Supabase",
+                description: "Wires the auth shell to Supabase Auth and emits onboarding/legal persistence SQL.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [
+                    runtime("@supabase/supabase-js", "^2.112.3"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/features/auth/adapters/supabase-auth-adapter.tsx", "{{featuresDir}}/auth/auth-adapter.tsx", "support"),
+                    mdsAsset("src/services/supabase.ts", "src/services/supabase.ts", "support"),
+                    mdsAsset("supabase/migrations/0001_mds_auth_onboarding.sql", "supabase/migrations/0001_mds_auth_onboarding.sql", "support"),
+                    mdsAsset("env/supabase.env.example", ".env.example", "support"),
+                    mdsAsset("project/auth-supabase.md", "project/auth.md", "support"),
+                ],
+                integration: [
+                    "Generated apps ship a blank .env.example template and a local .env.local with Supabase publishable credentials.",
+                    "Apply the generated Supabase migration before relying on onboarding or legal acceptance persistence.",
+                    "Keep Supabase service-role and secret keys out of Expo client code; use RLS policies for client-visible data.",
+                ],
+            },
+            {
+                id: "with-firebase",
+                name: "With Firebase",
+                description: "Wires the auth shell to Firebase Authentication through the Expo-compatible Firebase JS SDK.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [
+                    runtime("firebase", "^12.17.1", "expo"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/features/auth/adapters/firebase-auth-adapter.tsx", "{{featuresDir}}/auth/auth-adapter.tsx", "support"),
+                    mdsAsset("src/services/firebase.ts", "src/services/firebase.ts", "support"),
+                    mdsAsset("env/firebase.env.example", ".env.example", "support"),
+                    mdsAsset("project/auth-firebase.md", "project/auth.md", "support"),
+                ],
+                integration: [
+                    "Register a Firebase web app, enable Email/Password auth, and set the EXPO_PUBLIC_FIREBASE_* variables.",
+                    "Use Firebase JS SDK for this source-copy variant; React Native Firebase requires a development build and native config plugins.",
+                    "Add Firestore or another backend-backed audit path before treating legal acceptance as production-persistent.",
+                ],
+            },
+            {
+                id: "with-convex",
+                name: "With Convex",
+                description: "Wires the auth shell to Convex React Native and Convex Auth. Experimental.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [
+                    runtime("convex", "^1.43.0"),
+                    runtime("@convex-dev/auth", "^0.0.95"),
+                    runtime("@auth/core", "0.41.1"),
+                    runtime("expo-secure-store", "~56.0.4", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/features/auth/adapters/convex-auth-adapter.tsx", "{{featuresDir}}/auth/auth-adapter.tsx", "support"),
+                    mdsAsset("src/services/convex.ts", "src/services/convex.ts", "support"),
+                    mdsAsset("env/convex.env.example", ".env.example", "support"),
+                    mdsAsset("project/auth-convex.md", "project/auth.md", "support"),
+                ],
+                integration: [
+                    "Run npx convex dev and npx @convex-dev/auth before using the generated Convex auth adapter.",
+                    "Set EXPO_PUBLIC_CONVEX_URL for the Expo app.",
+                    "Treat this variant as experimental until the generated app is dogfooded with current Convex Auth APIs.",
+                ],
+            },
+        ],
         assets: [
-            mdsAsset("src/features/onboarding/onboarding-screen.tsx", "{{featuresDir}}/onboarding/onboarding-screen.tsx"),
-            mdsAsset("src/features/onboarding/agreement-screen.tsx", "{{featuresDir}}/onboarding/agreement-screen.tsx"),
-            mdsAsset("src/features/onboarding/terms-screen.tsx", "{{featuresDir}}/onboarding/terms-screen.tsx"),
-            mdsAsset("src/features/onboarding/account-setup-screen.tsx", "{{featuresDir}}/onboarding/account-setup-screen.tsx"),
-            mdsAsset("src/features/onboarding/legal-documents.ts", "{{featuresDir}}/onboarding/legal-documents.ts", "support"),
-            mdsAsset("src/features/onboarding/components/legal-document-view.tsx", "{{featuresDir}}/onboarding/components/legal-document-view.tsx", "support"),
-            mdsAsset("src/app/onboarding.tsx", "{{appDir}}/onboarding.tsx", "route"),
-            mdsAsset("src/app/onboarding/agreement.tsx", "{{appDir}}/onboarding/agreement.tsx", "route"),
-            mdsAsset("src/app/onboarding/terms.tsx", "{{appDir}}/onboarding/terms.tsx", "route"),
-            mdsAsset("src/app/onboarding/account-setup.tsx", "{{appDir}}/onboarding/account-setup.tsx", "route"),
+            mdsAsset("src/features/auth/auth-types.ts", "{{featuresDir}}/auth/auth-types.ts", "support"),
+            mdsAsset("src/features/auth/auth-provider.tsx", "{{featuresDir}}/auth/auth-provider.tsx", "support"),
+            mdsAsset("src/features/auth/auth-guard.tsx", "{{featuresDir}}/auth/auth-guard.tsx", "support"),
+            mdsAsset("src/features/auth/auth-guard-logic.ts", "{{featuresDir}}/auth/auth-guard-logic.ts", "support"),
+            mdsAsset("src/features/auth/auth-screen.tsx", "{{featuresDir}}/auth/auth-screen.tsx"),
+            mdsAsset("src/app/(auth)/sign-in.tsx", "{{appDir}}/(auth)/sign-in.tsx", "route"),
+            mdsAsset("src/app/(auth)/sign-up.tsx", "{{appDir}}/(auth)/sign-up.tsx", "route"),
+            mdsAsset("src/app/(auth)/reset-password.tsx", "{{appDir}}/(auth)/reset-password.tsx", "route"),
         ],
         integration: {
-            summary: "Add the generated onboarding routes to an Expo Router stack.",
+            summary: "Add editable auth routes and a provider-backed AuthProvider to an Expo Router app.",
             instructions: [
-                "Review and replace every bracketed legal placeholder with counsel before production.",
-                "Replace the account-setup handoff with the application’s separately implemented auth flow.",
+                "Keep /sign-in, /sign-up, and /reset-password public, then protect app routes from the root Expo Router layout.",
+                "Choose exactly one auth provider variant so auth-adapter.tsx has a single implementation.",
+                "Compose with mds/onboarding by setting onboarding completion to /sign-in when users should authenticate after onboarding.",
+                "Use AuthGuard for screen-level protection when a copied screen should refresh auth on focus or redirect independently from the root Stack.Protected shell.",
             ],
             notes: [
-                "This item is a preview flow and does not implement authentication.",
+                "Protected routes are a client-side navigation guard; provider backends and database policies still enforce data access.",
+                "The Firebase variant intentionally uses Firebase JS SDK, not React Native Firebase, so it stays Expo-compatible.",
+                "The Convex variant is experimental because Convex Auth is beta and requires a Convex initialization step.",
             ],
         },
         preview: {
-            description: "Legal consent, terms review, and account-flow handoff.",
+            description: "Sign-in, sign-up, password reset, auth provider, and provider-specific adapters.",
+        },
+    }),
+    defineItem({
+        id: "mds/onboarding",
+        name: "Onboarding flow",
+        description: "A reusable multi-screen onboarding flow with editable completion behavior and optional legal-document review.",
+        kind: "flow",
+        tags: ["onboarding", "multi-screen", "without-auth", "eject:onboarding"],
+        categories: ["onboarding", "flows"],
+        compatibility: SDK_56_ROUTER,
+        composedItems: ["mds/theme-support", "mds/onboarding-state"],
+        relatedItems: ["mds/legal-documents", "mds/onboarding-state", "mds/settings"],
+        variants: [
+            {
+                id: "multi-screen",
+                name: "Multi-screen onboarding",
+                description: "Adds welcome, feature highlights, and completion screens as Expo Router routes.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [runtime("expo-router", "~56.2.6", "expo")],
+                assets: [
+                    mdsAsset("src/features/onboarding/onboarding-config.ts", "{{featuresDir}}/onboarding/onboarding-config.ts", "support", ["__MDS_APP_NAME__"]),
+                    mdsAsset("src/features/onboarding/complete-screen.tsx", "{{featuresDir}}/onboarding/complete-screen.tsx"),
+                    mdsAsset("src/app/onboarding.tsx", "{{appDir}}/onboarding.tsx", "route"),
+                    mdsAsset("src/app/onboarding/features.tsx", "{{appDir}}/onboarding/features.tsx", "route"),
+                    mdsAsset("src/app/onboarding/complete.tsx", "{{appDir}}/onboarding/complete.tsx", "route"),
+                ],
+                integration: [
+                    "Edit onboarding-config.ts to change copy, feature highlights, completion label, completion mode, and final route.",
+                    "Completion calls the copied onboarding-state adapter. Replace the memory adapter before hosted production use.",
+                ],
+            },
+            {
+                id: "multi-screen-with-legal",
+                name: "Multi-screen onboarding with legal review",
+                description: "Adds welcome, feature highlights, and a final legal review step powered by mds/legal-documents.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [runtime("expo-router", "~56.2.6", "expo")],
+                composedItems: ["mds/legal-documents", "mds/onboarding-state"],
+                assets: [
+                    mdsAsset("src/features/onboarding/onboarding-config-with-legal.ts", "{{featuresDir}}/onboarding/onboarding-config.ts", "support", ["__MDS_APP_NAME__"]),
+                    mdsAsset("src/features/onboarding/legal-review-screen.tsx", "{{featuresDir}}/onboarding/legal-review-screen.tsx"),
+                    mdsAsset("src/app/onboarding.tsx", "{{appDir}}/onboarding.tsx", "route"),
+                    mdsAsset("src/app/onboarding/features.tsx", "{{appDir}}/onboarding/features.tsx", "route"),
+                    mdsAsset("src/app/onboarding/legal.tsx", "{{appDir}}/onboarding/legal.tsx", "route"),
+                ],
+                integration: [
+                    "Replace the placeholder legal content in mds/legal-documents before production release.",
+                    "The onboarding legal screen imports the shared legal document modal and acceptance hook instead of duplicating legal copy.",
+                    "Edit onboarding-config.ts to change the feature highlights, legal step copy, completion label, completion mode, and final route.",
+                ],
+            },
+        ],
+        assets: [
+            mdsAsset("src/features/onboarding/welcome-screen.tsx", "{{featuresDir}}/onboarding/welcome-screen.tsx"),
+            mdsAsset("src/features/onboarding/features-screen.tsx", "{{featuresDir}}/onboarding/features-screen.tsx"),
+        ],
+        integration: {
+            summary: "Add production onboarding routes to an Expo Router stack.",
+            instructions: [
+                "Start users at /onboarding, then replace or extend the copied screens as the product flow matures.",
+                "Use mds/onboarding-state to choose memory, Zustand-local, or Supabase persistence without changing the screens.",
+            ],
+            notes: [
+                "Onboarding UI does not import Zustand or Supabase directly.",
+                "The default composed persistence adapter is memory-only and is not a hosted legal audit record.",
+                "Preference/profile intake is intentionally omitted until the app can store the responses or change behavior from them.",
+                "Use a with-legal variant when onboarding needs legal review from mds/legal-documents.",
+            ],
+        },
+        preview: {
+            description: "Welcome, feature highlights, optional legal review, and editable completion handoff.",
+        },
+    }),
+    defineItem({
+        id: "mds/onboarding-state",
+        name: "Onboarding persistence adapters",
+        description: "Completion and legal-acceptance adapters for memory, Zustand-local, Supabase, or Zustand cache plus Supabase sync.",
+        kind: "integration",
+        tags: ["onboarding", "persistence", "adapter", "legal"],
+        categories: ["onboarding", "support"],
+        compatibility: SDK_56_ALIAS,
+        relatedItems: ["mds/onboarding", "mds/legal-documents", "mds/auth"],
+        variants: [
+            {
+                id: "memory",
+                name: "Memory adapter",
+                description: "In-process completion and legal acceptance. Useful for clean apps and demos, not hosted legal records.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                assets: [
+                    mdsAsset("src/features/onboarding-state/adapters/memory-onboarding-state-adapter.ts", "{{featuresDir}}/onboarding-state/onboarding-state-adapter.ts", "support"),
+                ],
+            },
+            {
+                id: "zustand-local",
+                name: "Zustand local adapter",
+                description: "Persists onboarding completion and legal acceptance on-device with Zustand. Not a hosted audit trail.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [
+                    runtime("zustand", "^5.0.8"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/features/onboarding-state/onboarding-store.ts", "{{featuresDir}}/onboarding-state/onboarding-store.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/onboarding-state-zustand.ts", "{{featuresDir}}/onboarding-state/onboarding-state-zustand.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/adapters/zustand-onboarding-state-adapter.ts", "{{featuresDir}}/onboarding-state/onboarding-state-adapter.ts", "support"),
+                ],
+            },
+            {
+                id: "supabase",
+                name: "Supabase adapter",
+                description: "Uses user_onboarding_state and user_legal_acceptances as the source of truth after sign-in.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [runtime("@supabase/supabase-js", "^2.112.3")],
+                assets: [
+                    mdsAsset("src/features/onboarding-state/onboarding-state-supabase.ts", "{{featuresDir}}/onboarding-state/onboarding-state-supabase.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/adapters/supabase-onboarding-state-adapter.ts", "{{featuresDir}}/onboarding-state/onboarding-state-adapter.ts", "support"),
+                ],
+                integration: [
+                    "Apply supabase/migrations/0001_mds_auth_onboarding.sql before relying on remote persistence.",
+                    "Legal writes require a signed-in user id. Pre-auth local acceptance is not a hosted record.",
+                ],
+            },
+            {
+                id: "zustand-supabase",
+                name: "Zustand cache plus Supabase",
+                description: "Zustand is the local cache and pending queue. Supabase remains the canonical store.",
+                compatibility: { navigation: ["expo-router"], aliases: ["@"] },
+                dependencies: [
+                    runtime("zustand", "^5.0.8"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                    runtime("@supabase/supabase-js", "^2.112.3"),
+                ],
+                assets: [
+                    mdsAsset("src/features/onboarding-state/onboarding-store.ts", "{{featuresDir}}/onboarding-state/onboarding-store.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/onboarding-state-supabase.ts", "{{featuresDir}}/onboarding-state/onboarding-state-supabase.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/onboarding-state-zustand-supabase.ts", "{{featuresDir}}/onboarding-state/onboarding-state-zustand-supabase.ts", "support"),
+                    mdsAsset("src/features/onboarding-state/adapters/zustand-supabase-onboarding-state-adapter.ts", "{{featuresDir}}/onboarding-state/onboarding-state-adapter.ts", "support"),
+                ],
+                integration: [
+                    "Apply supabase/migrations/0001_mds_auth_onboarding.sql before relying on remote persistence.",
+                    "Zustand must not be treated as the legal source of truth when this variant is selected.",
+                ],
+            },
+        ],
+        assets: [
+            mdsAsset("src/features/onboarding-state/onboarding-state-types.ts", "{{featuresDir}}/onboarding-state/onboarding-state-types.ts", "support"),
+            mdsAsset("src/features/onboarding-state/onboarding-state-core.ts", "{{featuresDir}}/onboarding-state/onboarding-state-core.ts", "support"),
+            mdsAsset("src/features/onboarding-state/onboarding-state-memory.ts", "{{featuresDir}}/onboarding-state/onboarding-state-memory.ts", "support"),
+            mdsAsset("src/features/onboarding-state/onboarding-state.ts", "{{featuresDir}}/onboarding-state/onboarding-state.ts", "support"),
+            mdsAsset("src/features/legal/legal-acceptance-config.ts", "{{featuresDir}}/legal/legal-acceptance-config.ts", "support"),
+        ],
+        integration: {
+            summary: "Copy adapter contracts and one persistence implementation for onboarding completion and legal acceptance.",
+            instructions: [
+                "Choose exactly one variant so onboarding-state-adapter.ts has a single implementation.",
+                "Import the copied onboarding-state module from screens and legal hooks instead of Zustand or Supabase.",
+                "Memory and Zustand-local are not hosted legal audit records.",
+            ],
+            notes: [
+                "Supabase variants write user-scoped, version-aware legal rows and do not update or delete those rows from the client.",
+                "Zustand is canonical only for the zustand-local variant. With Supabase it is cache-only.",
+            ],
+        },
+    }),
+    defineItem({
+        id: "mds/onboarding-auth-supabase",
+        name: "Onboarding plus Supabase auth composition",
+        description: "Wires onboarding, Supabase auth, and user-scoped onboarding persistence.",
+        kind: "integration",
+        tags: ["onboarding", "auth", "supabase", "persistence", "with-auth"],
+        categories: ["onboarding", "auth", "flows"],
+        compatibility: SDK_56_ROUTER,
+        composedItems: [
+            "mds/onboarding",
+            "mds/auth",
+            "mds/onboarding-state",
+        ],
+        relatedItems: ["mds/settings"],
+        assets: [
+            mdsAsset("src/features/onboarding/onboarding-persistence-sync.tsx", "{{featuresDir}}/onboarding/onboarding-persistence-sync.tsx", "support"),
+        ],
+        integration: {
+            summary: "Compose onboarding and Supabase auth, then replace the default memory persistence adapter with a Supabase-backed adapter.",
+            instructions: [
+                "Install mds/onboarding-state --variant supabase or zustand-supabase so hosted legal acceptance is user-scoped.",
+                "Keep /sign-in and /sign-up public; include legal routes only when mds/legal-documents is selected separately or through legal onboarding.",
+                "If legal onboarding is selected, prefer intro, features, auth, then legal so legal rows are written with a known user id.",
+                "Apply supabase/migrations/0001_mds_auth_onboarding.sql; generated apps include .env.local with Supabase publishable credentials plus a blank tracked .env.example template.",
+            ],
+            notes: [
+                "This composition does not add mds/db and does not install Firebase or Convex persistence.",
+                "Zustand remains a cache when both Zustand and Supabase are selected.",
+            ],
+        },
+    }),
+    defineItem({
+        id: "mds/db",
+        name: "Database adapter contract",
+        description: "Provider-neutral database adapter contract with Supabase implementation and Firebase skeleton.",
+        kind: "integration",
+        tags: ["database", "data", "adapter", "supabase", "firebase", "eject:data"],
+        categories: ["data", "support"],
+        compatibility: SDK_56_ALIAS,
+        relatedItems: ["mds/auth", "mds/data-local", "mds/onboarding-state"],
+        variants: [
+            {
+                id: "supabase",
+                name: "Supabase adapter",
+                description: "Copies the provider-neutral contract, typed app schema, Supabase adapter, and Supabase-only factory.",
+                dependencies: [
+                    runtime("@supabase/supabase-js", "^2.112.3"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/db/supabase.ts", "src/db/supabase.ts", "support"),
+                    mdsAsset("src/db/index.supabase.ts", "src/db/index.ts", "support"),
+                    mdsAsset("src/services/supabase.ts", "src/services/supabase.ts", "support"),
+                    mdsAsset("env/supabase.env.example", ".env.example", "support"),
+                ],
+                integration: [
+                    "Use getAdapter() from src/db/index.ts instead of importing Supabase directly from screens or feature logic.",
+                    "Keep Supabase service-role and secret keys out of Expo client code.",
+                    "Use Postgres functions or server routes for atomic multi-step writes; the generated client transaction method is a callback boundary only.",
+                ],
+            },
+            {
+                id: "firebase",
+                name: "Firebase skeleton",
+                description: "Copies the provider-neutral contract, typed app schema, Firebase skeleton adapter, and Firebase-only factory.",
+                dependencies: [
+                    runtime("firebase", "^12.17.1"),
+                    runtime("@react-native-async-storage/async-storage", "2.2.0", "expo"),
+                ],
+                assets: [
+                    mdsAsset("src/db/firebase.ts", "src/db/firebase.ts", "support"),
+                    mdsAsset("src/db/index.firebase.ts", "src/db/index.ts", "support"),
+                    mdsAsset("src/services/firebase.ts", "src/services/firebase.ts", "support"),
+                    mdsAsset("env/firebase.env.example", ".env.example", "support"),
+                ],
+                integration: [
+                    "Treat the Firebase adapter as a skeleton until Firestore collection paths, auth rules, and query mapping are defined.",
+                    "Wire Firestore onSnapshot for subscriptions after the app schema is finalized.",
+                    "Use Firebase JS SDK for this source-copy variant; React Native Firebase requires a development build and native config plugins.",
+                ],
+            },
+        ],
+        assets: [
+            mdsAsset("src/db/adapter.ts", "src/db/adapter.ts", "support"),
+            mdsAsset("src/types/database.ts", "src/types/database.ts", "support"),
+        ],
+        integration: {
+            summary: "Copy the stable database adapter contract and one provider implementation into generated apps.",
+            instructions: [
+                "Keep product code typed against DatabaseAdapter and the app-specific AppDatabase schema.",
+                "Choose exactly one provider variant so src/db/index.ts imports only the selected backend.",
+                "Extend src/types/database.ts with the app's real table or collection rows before building product data flows.",
+            ],
+            notes: [
+                "This is a narrow data boundary, not an ORM, migration system, or query builder.",
+                "The Supabase adapter supports reads, writes, realtime subscriptions, and contract-level error mapping.",
+                "The Firebase variant is intentionally a skeleton because Firestore document paths are app-specific.",
+            ],
         },
     }),
     defineItem({
         id: "mds/settings",
         name: "Settings screen",
-        description: "The generated MDS settings modal with a keyboard-controller form example.",
+        description: "A reusable settings surface with account summary, sign-out, legal links, and app version details.",
         kind: "screen",
         tags: ["settings", "form", "eject:settings"],
         categories: ["settings", "screens"],
@@ -448,15 +836,19 @@ const mdsItems = [
                 ],
             },
         ],
-        composedItems: ["swmansion/keyboard-form", "mds/theme-support"],
-        relatedItems: ["mds/onboarding-preview"],
+        composedItems: ["mds/theme-support"],
+        relatedItems: ["mds/onboarding", "mds/legal-documents", "mds/auth"],
         assets: [
+            mdsAsset("src/features/auth/auth-types.ts", "{{featuresDir}}/auth/auth-types.ts", "support"),
             mdsAsset("src/features/settings/settings-screen.tsx", "{{featuresDir}}/settings/settings-screen.tsx"),
+            mdsAsset("src/features/settings/settings-screen-logic.ts", "{{featuresDir}}/settings/settings-screen-logic.ts", "support"),
         ],
         integration: {
-            summary: "Register the settings route as a modal in the root Expo Router stack.",
+            summary: "Register the settings route as a modal in the root Expo Router stack and pass a real auth adapter when the app has authentication.",
             instructions: [
                 "Add a settings route link from an application-owned screen or menu.",
+                "Pass local /terms and /privacy routes when legal documents are installed, and optionally pass an external GDPR URL when compliance copy lives off-app.",
+                "Use the placeholder route wrapper only as a starter; generated apps with auth should wire SettingsScreen to the active adapter.",
             ],
         },
     }),
@@ -848,6 +1240,29 @@ const nativeWindUiItems = [
     }),
 ];
 const ceaItems = [
+    defineItem({
+        id: "expo/splash-screen",
+        name: "Expo SDK 56 splash screen",
+        description: "Light and dark splash icons and expo-splash-screen plugin config matching create-expo-app on SDK 56.",
+        kind: "integration",
+        source: CEA_SOURCE,
+        tags: ["expo", "splash", "appearance"],
+        categories: ["theming", "support"],
+        compatibility: SDK_56_CEA_ASSETS,
+        dependencies: [runtime("expo-splash-screen", "~56.0.14", "expo")],
+        assets: [
+            ceaAsset("assets/images/expo-logo.png", "assets/images/splash-icon.png", "static", "binary"),
+            ceaAsset("assets/images/expo-badge-white.png", "assets/images/splash-icon-dark.png", "static", "binary"),
+        ],
+        integration: {
+            summary: "Install the SDK 56 splash icons and configure expo-splash-screen for system light and dark appearance.",
+            instructions: [
+                "Set expo.userInterfaceStyle to automatic.",
+                "Add the expo-splash-screen config plugin with light and dark image and backgroundColor values.",
+                "Keep the splash assets under assets/images, matching create-expo-app.",
+            ],
+        },
+    }),
     defineItem({
         id: "expo/theme-support",
         name: "Expo starter theme support",