kitcn 0.13.2 → 0.13.4

package/dist/{backend-core-B4DHUUfg.mjs → backend-core-D2a2poAE.mjs}

@@ -5967,7 +5967,7 @@ const syncEnv = pushEnv;
 //#endregion
 //#region src/cli/project-context.ts
 function isReactScaffoldFramework(framework) {
-	return framework !== "next-app";
+	return framework !== "next-app" && framework !== "expo";
 }
 const NEXT_CONFIG_FILES = [
 	"next.config.ts",
@@ -5999,6 +5999,13 @@ const GATSBY_CONFIG_FILES = [
 	"gatsby-config.mjs",
 	"gatsby-config.cjs"
 ];
+const EXPO_CONFIG_FILES = [
+	"app.json",
+	"app.config.ts",
+	"app.config.js",
+	"app.config.mjs",
+	"app.config.cjs"
+];
 const LEADING_SLASH_RE = /^\/+/;
 const TS_ALIAS_RE = /"@\/\*"\s*:\s*\[\s*"([^"]+)"\s*\]/m;
 function hasAnyFile(cwd, relativePaths) {
@@ -6054,7 +6061,7 @@ function inferUsesSrcFromAppDirs(cwd) {
 function inferUsesSrc(cwd, mode) {
 	const signals = [
 		inferUsesSrcFromComponentsJson(cwd),
-		mode === "next-app" ? inferUsesSrcFromAppDirs(cwd) : null,
+		mode === "next-app" || mode === "expo" ? inferUsesSrcFromAppDirs(cwd) : null,
 		inferUsesSrcFromComponentRoots(cwd),
 		inferUsesSrcFromTsconfig(cwd),
 		fs.existsSync(resolve(cwd, "src")) ? true : null
@@ -6085,6 +6092,7 @@ function detectProjectFramework(cwd = process.cwd()) {
 	if (fs.existsSync(resolve(cwd, "composer.json"))) return "laravel";
 	if (hasDependency$1(packageJson, (dependency) => dependency.startsWith("@remix-run/"))) return "remix";
 	if (hasDependency$1(packageJson, (dependency) => dependency.startsWith("@tanstack/react-start"))) return "tanstack-start";
+	if (hasAnyFile(cwd, EXPO_CONFIG_FILES) && hasDependency$1(packageJson, (dependency) => dependency === "expo" || dependency === "expo-router")) return "expo";
 	if (hasAnyFile(cwd, REACT_ROUTER_CONFIG_FILES)) return "react-router";
 	if (hasAnyFile(cwd, VITE_CONFIG_FILES)) return "vite";
 	if (hasDependency$1(packageJson, (dependency) => dependency === "react" || dependency === "react-dom")) return "manual";
@@ -6092,15 +6100,16 @@ function detectProjectFramework(cwd = process.cwd()) {
 }
 function mapFrameworkToScaffoldMode(framework) {
 	if (framework === "next-app") return "next-app";
+	if (framework === "expo") return "expo";
 	if (framework === "next-pages" || framework === "vite" || framework === "react-router" || framework === "tanstack-start" || framework === "manual") return "react";
-	throw new Error(`Unsupported framework "${framework}" for kitcn init. Supported frameworks map to: next-app, next-pages, vite, react-router, tanstack-start, manual.`);
+	throw new Error(`Unsupported framework "${framework}" for kitcn init. Supported frameworks map to: next-app, expo, next-pages, vite, react-router, tanstack-start, manual.`);
 }
 function resolveProjectScaffoldContext(params = {}) {
 	const cwd = params.cwd ?? process.cwd();
-	const detectedFramework = (params.template === "next" ? "next-app" : params.template === "start" ? "tanstack-start" : params.template === "vite" ? "vite" : null) ?? detectProjectFramework(cwd);
+	const detectedFramework = (params.template === "next" ? "next-app" : params.template === "expo" ? "expo" : params.template === "start" ? "tanstack-start" : params.template === "vite" ? "vite" : null) ?? detectProjectFramework(cwd);
 	if (!detectedFramework) {
 		if (params.allowMissing) return null;
-		throw new Error("Could not detect a supported app scaffold. Supported modes currently start from `next`, `start`, or `vite`.");
+		throw new Error("Could not detect a supported app scaffold. Supported modes currently start from `next`, `expo`, `start`, or `vite`.");
 	}
 	let mode;
 	try {
@@ -6132,6 +6141,23 @@ function resolveProjectScaffoldContext(params = {}) {
 			convexSiteUrlEnvKey: "NEXT_PUBLIC_CONVEX_SITE_URL"
 		};
 	}
+	if (mode === "expo") {
+		const appDir = posix.join(rootPrefix, "app").replace(LEADING_SLASH_RE, "");
+		return {
+			framework: "expo",
+			mode,
+			usesSrc,
+			appDir,
+			componentsDir,
+			libDir,
+			convexClientDir,
+			tailwindCssPath: null,
+			tsconfigAliasPath,
+			clientSiteUrlEnvKey: "EXPO_PUBLIC_SITE_URL",
+			convexUrlEnvKey: "EXPO_PUBLIC_CONVEX_URL",
+			convexSiteUrlEnvKey: "EXPO_PUBLIC_CONVEX_SITE_URL"
+		};
+	}
 	const clientEntryFile = resolveReactClientEntryFile(cwd, usesSrc);
 	const viteConfigFile = VITE_CONFIG_FILES.find((relativePath) => fs.existsSync(resolve(cwd, relativePath)));
 	const tsconfigAppFile = ["tsconfig.app.json", "tsconfig.json"].find((relativePath) => fs.existsSync(resolve(cwd, relativePath)));
@@ -6467,6 +6493,51 @@ const createRegistryFile = (params) => {
 	};
 };
 
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-convex-provider.template.ts
+const INIT_EXPO_CONVEX_PROVIDER_TEMPLATE = `import { QueryClientProvider as TanstackQueryClientProvider } from '@tanstack/react-query';
+import {
+  ConvexProvider,
+  ConvexReactClient,
+  getConvexQueryClientSingleton,
+  getQueryClientSingleton,
+} from 'kitcn/react';
+import type { ReactNode } from 'react';
+
+import { CRPCProvider } from '@/lib/convex/crpc';
+import { createQueryClient } from '@/lib/convex/query-client';
+
+const convex = new ConvexReactClient(process.env.EXPO_PUBLIC_CONVEX_URL!);
+
+export function AppConvexProvider({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  return (
+    <ConvexProvider client={convex}>
+      <QueryProvider>{children}</QueryProvider>
+    </ConvexProvider>
+  );
+}
+
+function QueryProvider({ children }: { children: ReactNode }) {
+  const queryClient = getQueryClientSingleton(createQueryClient);
+  const convexQueryClient = getConvexQueryClientSingleton({
+    convex,
+    queryClient,
+  });
+
+  return (
+    <TanstackQueryClientProvider client={queryClient}>
+      <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
+        {children}
+      </CRPCProvider>
+    </TanstackQueryClientProvider>
+  );
+}
+`;
+
 //#endregion
 //#region src/cli/scaffold-placeholders.ts
 const FUNCTIONS_DIR_IMPORT_PLACEHOLDER$5 = "__KITCN_FUNCTIONS_DIR__";
@@ -7135,10 +7206,10 @@ const resolvePluginScaffoldFiles = (templates, roots, functionsDir, existingTemp
 	if (template.target === "lib") rootDir = roots.libRootDir;
 	else if (template.target === "functions") rootDir = roots.functionsRootDir;
 	else if (template.target === "app") {
-		if (!roots.appRootDir) throw new Error(`${descriptor.label} scaffolding requires a supported app baseline. Run \`kitcn init --yes\` in a supported app, or bootstrap one with \`kitcn init -t <next|start|vite>\` first.`);
+		if (!roots.appRootDir) throw new Error(`${descriptor.label} scaffolding requires a supported app baseline. Run \`kitcn init --yes\` in a supported app, or bootstrap one with \`kitcn init -t <next|expo|start|vite>\` first.`);
 		rootDir = roots.appRootDir;
 	} else {
-		if (!roots.clientLibRootDir) throw new Error(`${descriptor.label} scaffolding requires a supported app baseline. Run \`kitcn init --yes\` in a supported app, or bootstrap one with \`kitcn init -t <next|start|vite>\` first.`);
+		if (!roots.clientLibRootDir) throw new Error(`${descriptor.label} scaffolding requires a supported app baseline. Run \`kitcn init --yes\` in a supported app, or bootstrap one with \`kitcn init -t <next|expo|start|vite>\` first.`);
 		rootDir = roots.clientLibRootDir;
 	}
 	const mappedLockfilePath = existingTemplatePathMap?.[template.id];
@@ -8049,6 +8120,32 @@ export default defineAuth(() => ({
   trustedOrigins: [getEnv().SITE_URL],
 }));
 `;
+const AUTH_EXPO_TEMPLATE = `import { expo } from '@better-auth/expo';
+import { convex } from 'kitcn/auth';
+import { getEnv } from '../lib/get-env';
+import authConfig from './auth.config';
+import { defineAuth } from './generated/auth';
+
+export default defineAuth(() => ({
+  emailAndPassword: {
+    enabled: true,
+  },
+  baseURL: getEnv().CONVEX_SITE_URL ?? getEnv().SITE_URL,
+  plugins: [
+    expo(),
+    convex({
+      authConfig,
+      jwks: getEnv().JWKS,
+    }),
+  ],
+  session: {
+    expiresIn: 60 * 60 * 24 * 30,
+    updateAge: 60 * 60 * 24 * 15,
+  },
+  telemetry: { enabled: false },
+  trustedOrigins: [getEnv().SITE_URL],
+}));
+`;
 const AUTH_CONVEX_TEMPLATE = `import { convex } from 'kitcn/auth';
 import authConfig from './auth.config';
 import { defineAuth } from './generated/auth';
@@ -8117,6 +8214,38 @@ export const authClient = createAuthClient({
   plugins: [convexClient()],
 });
 
+export const {
+  useSignInMutationOptions,
+  useSignOutMutationOptions,
+  useSignUpMutationOptions,
+} = createAuthMutations(authClient);
+`;
+const AUTH_EXPO_CLIENT_TEMPLATE = `import { expoClient } from '@better-auth/expo/client';
+import Constants from 'expo-constants';
+import * as SecureStore from 'expo-secure-store';
+import { createAuthClient } from 'better-auth/react';
+import { convexClient } from 'kitcn/auth/client';
+import { createAuthMutations } from 'kitcn/react';
+import { Platform } from 'react-native';
+
+const scheme = Constants.expoConfig?.scheme as string;
+
+export const authClient = createAuthClient({
+  baseURL: process.env.EXPO_PUBLIC_CONVEX_SITE_URL!,
+  plugins: [
+    convexClient(),
+    ...(Platform.OS === 'web'
+      ? []
+      : [
+          expoClient({
+            scheme,
+            storagePrefix: scheme,
+            storage: SecureStore,
+          }),
+        ]),
+  ],
+});
+
 export const {
   useSignInMutationOptions,
   useSignOutMutationOptions,
@@ -8372,6 +8501,293 @@ export const router = c.router;
 `;
 }
 
+//#endregion
+//#region src/cli/registry/items/auth/auth-expo-convex-provider.template.ts
+const AUTH_EXPO_CONVEX_PROVIDER_TEMPLATE = `import { QueryClientProvider as TanstackQueryClientProvider } from '@tanstack/react-query';
+import { useRouter } from 'expo-router';
+import { ConvexAuthProvider } from 'kitcn/auth/client';
+import {
+  ConvexReactClient,
+  getConvexQueryClientSingleton,
+  getQueryClientSingleton,
+  useAuthStore,
+} from 'kitcn/react';
+import type { ReactNode } from 'react';
+
+import { authClient } from '@/lib/convex/auth-client';
+import { CRPCProvider } from '@/lib/convex/crpc';
+import { createQueryClient } from '@/lib/convex/query-client';
+
+const convex = new ConvexReactClient(process.env.EXPO_PUBLIC_CONVEX_URL!);
+
+export function AppConvexProvider({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  const router = useRouter();
+
+  return (
+    <ConvexAuthProvider
+      authClient={authClient}
+      client={convex}
+      onMutationUnauthorized={() => {
+        router.push('/auth');
+      }}
+      onQueryUnauthorized={() => {
+        router.push('/auth');
+      }}
+    >
+      <QueryProvider>{children}</QueryProvider>
+    </ConvexAuthProvider>
+  );
+}
+
+function QueryProvider({ children }: { children: ReactNode }) {
+  const authStore = useAuthStore();
+  const queryClient = getQueryClientSingleton(createQueryClient);
+  const convexQueryClient = getConvexQueryClientSingleton({
+    authStore,
+    convex,
+    queryClient,
+  });
+
+  return (
+    <TanstackQueryClientProvider client={queryClient}>
+      <CRPCProvider convexClient={convex} convexQueryClient={convexQueryClient}>
+        {children}
+      </CRPCProvider>
+    </TanstackQueryClientProvider>
+  );
+}
+`;
+
+//#endregion
+//#region src/cli/registry/items/auth/auth-expo-page.template.ts
+const AUTH_EXPO_PAGE_TEMPLATE = `import { useMutation } from '@tanstack/react-query';
+import { useAuth } from 'kitcn/react';
+import { useState } from 'react';
+import {
+  Pressable,
+  SafeAreaView,
+  StyleSheet,
+  Text,
+  TextInput,
+  View,
+} from 'react-native';
+
+import {
+  authClient,
+  useSignInMutationOptions,
+  useSignOutMutationOptions,
+  useSignUpMutationOptions,
+} from '@/lib/convex/auth-client';
+
+export default function AuthPage() {
+  const { hasSession } = useAuth();
+  const authSession = authClient.useSession();
+  const session = authSession.data;
+  const user = session?.user ?? null;
+  const hasSignedInUser = hasSession || Boolean(user);
+  const [mode, setMode] = useState<'signin' | 'signup'>('signin');
+  const [name, setName] = useState('');
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+
+  const signIn = useMutation(useSignInMutationOptions());
+  const signUp = useMutation(useSignUpMutationOptions());
+  const signOut = useMutation(useSignOutMutationOptions());
+
+  const errorMessage =
+    signIn.error?.message ??
+    signUp.error?.message ??
+    signOut.error?.message ??
+    null;
+  const isPending =
+    signIn.isPending || signUp.isPending || signOut.isPending;
+
+  function handleSubmit() {
+    if (mode === 'signup') {
+      signUp.mutate({
+        email,
+        name,
+        password,
+      });
+      return;
+    }
+
+    signIn.mutate({
+      email,
+      password,
+    });
+  }
+
+  if (hasSignedInUser) {
+    return (
+      <SafeAreaView style={styles.safeArea}>
+        <View style={styles.screen}>
+          <View style={styles.header}>
+            <Text style={styles.kicker}>Signed in</Text>
+            <Text style={styles.title}>
+              {user?.name || user?.email || email}
+            </Text>
+            <Text style={styles.copy}>{user?.email || email}</Text>
+          </View>
+          <Pressable
+            disabled={isPending}
+            onPress={() => signOut.mutate()}
+            style={[styles.button, isPending && styles.buttonDisabled]}
+          >
+            <Text style={styles.buttonText}>
+              {signOut.isPending ? 'Signing out…' : 'Sign out'}
+            </Text>
+          </Pressable>
+        </View>
+      </SafeAreaView>
+    );
+  }
+
+  return (
+    <SafeAreaView style={styles.safeArea}>
+      <View style={styles.screen}>
+        <View style={styles.header}>
+          <Text style={styles.kicker}>Auth demo</Text>
+          <Text style={styles.title}>
+            {mode === 'signup' ? 'Create an account' : 'Sign in'}
+          </Text>
+          <Text style={styles.copy}>
+            Minimal Better Auth wiring on top of the Expo baseline.
+          </Text>
+        </View>
+
+        <View style={styles.form}>
+          {mode === 'signup' ? (
+            <TextInput
+              autoCapitalize="words"
+              onChangeText={setName}
+              placeholder="Name"
+              style={styles.input}
+              value={name}
+            />
+          ) : null}
+          <TextInput
+            autoCapitalize="none"
+            keyboardType="email-address"
+            onChangeText={setEmail}
+            placeholder="Email"
+            style={styles.input}
+            value={email}
+          />
+          <TextInput
+            onChangeText={setPassword}
+            placeholder="Password"
+            secureTextEntry
+            style={styles.input}
+            value={password}
+          />
+          <Pressable
+            disabled={isPending}
+            onPress={handleSubmit}
+            style={[styles.button, isPending && styles.buttonDisabled]}
+          >
+            <Text style={styles.buttonText}>
+              {isPending
+                ? 'Working…'
+                : mode === 'signup'
+                  ? 'Create account'
+                  : 'Sign in'}
+            </Text>
+          </Pressable>
+        </View>
+
+        <Pressable
+          onPress={() => setMode(mode === 'signin' ? 'signup' : 'signin')}
+        >
+          <Text style={styles.link}>
+            {mode === 'signin'
+              ? "Don't have an account? Sign up"
+              : 'Already have an account? Sign in'}
+          </Text>
+        </Pressable>
+
+        {errorMessage ? <Text style={styles.error}>{errorMessage}</Text> : null}
+      </View>
+    </SafeAreaView>
+  );
+}
+
+const styles = StyleSheet.create({
+  safeArea: {
+    flex: 1,
+    backgroundColor: '#ffffff',
+  },
+  screen: {
+    flex: 1,
+    gap: 20,
+    justifyContent: 'center',
+    paddingHorizontal: 24,
+    paddingVertical: 32,
+  },
+  header: {
+    gap: 8,
+  },
+  kicker: {
+    color: '#6b7280',
+    fontSize: 12,
+    fontWeight: '600',
+    letterSpacing: 1.5,
+    textTransform: 'uppercase',
+  },
+  title: {
+    color: '#111827',
+    fontSize: 28,
+    fontWeight: '700',
+  },
+  copy: {
+    color: '#4b5563',
+    fontSize: 15,
+    lineHeight: 22,
+  },
+  form: {
+    gap: 12,
+  },
+  input: {
+    borderColor: '#d1d5db',
+    borderRadius: 12,
+    borderWidth: 1,
+    fontSize: 16,
+    minHeight: 48,
+    paddingHorizontal: 14,
+    paddingVertical: 12,
+  },
+  button: {
+    alignItems: 'center',
+    backgroundColor: '#111827',
+    borderRadius: 12,
+    minHeight: 48,
+    justifyContent: 'center',
+    paddingHorizontal: 16,
+  },
+  buttonDisabled: {
+    opacity: 0.5,
+  },
+  buttonText: {
+    color: '#ffffff',
+    fontSize: 15,
+    fontWeight: '600',
+  },
+  link: {
+    color: '#4b5563',
+    fontSize: 14,
+    textDecorationLine: 'underline',
+  },
+  error: {
+    color: '#dc2626',
+    fontSize: 14,
+  },
+});
+`;
+
 //#endregion
 //#region src/cli/registry/items/auth/auth-next-route.template.ts
 const AUTH_NEXT_ROUTE_TEMPLATE = `import { handler } from '@/lib/convex/server';
@@ -9679,14 +10095,24 @@ const AUTH_PROVIDER_REACT_NODE_IMPORT_RE = /import\s+type\s+\{\s*ReactNode\s*\}\
 const AUTH_CONVEX_NEXT_PROVIDER_RETURN_RE = /<ConvexProvider client=\{convex\}>[\s\S]*?<\/ConvexProvider>/;
 const AUTH_CONVEX_REACT_PROVIDER_OPEN_RE = /<ConvexProvider client=\{convex\}>/;
 const AUTH_CONVEX_REACT_PROVIDER_CLOSE_RE = /<\/ConvexProvider>/;
-const AUTH_ENV_FIELDS = [{
-	bootstrap: { kind: "generated-secret" },
-	key: "BETTER_AUTH_SECRET",
-	schema: "z.string().optional()"
-}, {
-	key: "JWKS",
-	schema: "z.string().optional()"
-}];
+const AUTH_ENV_FIELDS = [
+	{
+		bootstrap: { kind: "generated-secret" },
+		key: "BETTER_AUTH_SECRET",
+		schema: "z.string().optional()"
+	},
+	{
+		key: "JWKS",
+		schema: "z.string().optional()"
+	},
+	{
+		key: "CONVEX_SITE_URL",
+		schema: "z.string().optional()"
+	}
+];
+const BETTER_AUTH_EXPO_INSTALL_SPEC = "@better-auth/expo@1.6.5";
+const EXPO_SECURE_STORE_INSTALL_SPEC = "expo-secure-store@~55.0.8";
+const EXPO_NETWORK_INSTALL_SPEC = "expo-network@~55.0.8";
 const AUTH_FILES = [
 	createRegistryFile({
 		id: "auth-config",
@@ -9844,7 +10270,16 @@ app.use(
 }
 function buildAuthProviderPlanFile(params) {
 	const projectContext = params.roots.projectContext;
-	if (!projectContext) throw new Error("Auth scaffolding requires a supported app baseline. Run `kitcn init --yes` in a supported app, or bootstrap one with `kitcn init -t <next|start|vite>` first.");
+	if (!projectContext) throw new Error("Auth scaffolding requires a supported app baseline. Run `kitcn init --yes` in a supported app, or bootstrap one with `kitcn init -t <next|expo|start|vite>` first.");
+	if (projectContext.framework === "expo") return createPlanFile({
+		kind: "scaffold",
+		filePath: resolve(process.cwd(), projectContext.convexClientDir, "convex-provider.tsx"),
+		content: AUTH_EXPO_CONVEX_PROVIDER_TEMPLATE,
+		managedBaselineContent: INIT_EXPO_CONVEX_PROVIDER_TEMPLATE,
+		createReason: "Create auth-aware kitcn provider for the Expo scaffold.",
+		updateReason: "Update kitcn provider with auth-aware client wiring.",
+		skipReason: "kitcn provider already matches the auth scaffold."
+	});
 	if (projectContext.framework === "tanstack-start") return createPlanFile({
 		kind: "scaffold",
 		filePath: resolve(process.cwd(), projectContext.convexClientDir, "convex-provider.tsx"),
@@ -9939,6 +10374,18 @@ function buildAuthStartPagePlanFile(params) {
 		skipReason: "The Start auth demo route already exists."
 	});
 }
+function buildAuthExpoPagePlanFile(params) {
+	const projectContext = params.roots.projectContext;
+	if (!projectContext || projectContext.framework !== "expo") throw new Error("Auth scaffolding requires a supported Expo shell.");
+	return createPlanFile({
+		kind: "scaffold",
+		filePath: resolve(process.cwd(), projectContext.appDir, "auth.tsx"),
+		content: AUTH_EXPO_PAGE_TEMPLATE,
+		createReason: "Create the Expo auth demo route.",
+		updateReason: "Update the Expo auth demo route.",
+		skipReason: "The Expo auth demo route already exists."
+	});
+}
 function buildAuthConvexLocalEnvPlanFile(params) {
 	const envPath = resolve(params.functionsDir, ".env");
 	return createPlanFile({
@@ -10097,6 +10544,25 @@ const authRegistryItem = defineInternalRegistryItem({
 			})),
 			resolveTemplates: ({ roots, templates }) => {
 				if (!roots.projectContext || roots.projectContext.mode === "next-app") return templates;
+				if (roots.projectContext.framework === "expo") return templates.filter((template) => template.id !== "auth-page").map((template) => {
+					if (template.id === "auth-runtime") return {
+						...template,
+						content: AUTH_EXPO_TEMPLATE,
+						dependencyHintMessage: "Expo auth runtime needs the Better Auth Expo plugin.",
+						dependencyHints: [OPENTELEMETRY_API_INSTALL_SPEC, BETTER_AUTH_EXPO_INSTALL_SPEC]
+					};
+					if (template.id === "auth-client") return {
+						...template,
+						content: AUTH_EXPO_CLIENT_TEMPLATE,
+						dependencyHintMessage: "Expo auth client needs native Better Auth and Expo storage dependencies.",
+						dependencyHints: [
+							BETTER_AUTH_EXPO_INSTALL_SPEC,
+							EXPO_SECURE_STORE_INSTALL_SPEC,
+							EXPO_NETWORK_INSTALL_SPEC
+						]
+					};
+					return template;
+				});
 				if (roots.projectContext.framework === "tanstack-start") return templates.filter((template) => template.id !== "auth-page" && template.id !== "auth-page-convex").map((template) => {
 					if (template.id === "auth-client") return {
 						...template,
@@ -10133,6 +10599,7 @@ const authRegistryItem = defineInternalRegistryItem({
 					buildAuthProviderPlanFile(params)
 				];
 				if (roots.projectContext?.mode === "next-app") files.push(buildAuthNextServerPlanFile(params), buildAuthNextRoutePlanFile(params));
+				else if (roots.projectContext?.framework === "expo") files.push(buildAuthExpoPagePlanFile(params));
 				else if (roots.projectContext?.framework === "tanstack-start") files.push(buildAuthStartServerPlanFile(params), buildAuthStartRoutePlanFile(params), buildAuthStartServerCallPlanFile(params), buildAuthStartPagePlanFile(params));
 				return files;
 			},
@@ -11784,6 +12251,348 @@ const resolvePluginDocTopic = (topic) => {
 	};
 };
 
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-crpc.template.ts
+const INIT_EXPO_CRPC_TEMPLATE = `import { api } from '@convex/api';
+import { createCRPCContext } from 'kitcn/react';
+
+export const { CRPCProvider, useCRPC, useCRPCClient } = createCRPCContext({
+  api,
+  convexSiteUrl: process.env.EXPO_PUBLIC_CONVEX_SITE_URL!,
+});
+`;
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-env.template.ts
+const INIT_EXPO_ENV_DEFAULTS = {
+	EXPO_PUBLIC_CONVEX_URL: "http://127.0.0.1:3210",
+	EXPO_PUBLIC_CONVEX_SITE_URL: "http://127.0.0.1:3211",
+	EXPO_PUBLIC_SITE_URL: "http://localhost:3000"
+};
+function renderInitExpoEnvTemplate(source) {
+	const existing = source ? parse(source) : {};
+	const lines = Object.entries(INIT_EXPO_ENV_DEFAULTS).map(([key, value]) => `${key}=${existing[key] ?? value}`);
+	for (const [key, value] of Object.entries(existing)) if (!(key in INIT_EXPO_ENV_DEFAULTS)) lines.push(`${key}=${value}`);
+	return `${lines.join("\n")}\n`;
+}
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-env-types.template.ts
+const INIT_EXPO_ENV_TYPES_TEMPLATE = `/// <reference types="expo/types" />
+
+declare module '*.module.css' {
+  const classes: Record<string, string>;
+  export default classes;
+}
+`;
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-explore.template.ts
+const INIT_EXPO_EXPLORE_TEMPLATE = `import { Redirect } from 'expo-router';
+
+export default function ExploreScreen() {
+  return <Redirect href="/" />;
+}
+`;
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-gitignore.template.ts
+const EXPO_ENV_TYPES_IGNORE_LINE = "expo-env.d.ts";
+const LINE_SPLIT_RE = /\r?\n/;
+function renderInitExpoGitignoreTemplate(source = "") {
+	return `${source.split(LINE_SPLIT_RE).map((line) => line.trimEnd()).filter((line) => line.length > 0).filter((line) => line !== EXPO_ENV_TYPES_IGNORE_LINE).join("\n")}\n`;
+}
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-layout.template.ts
+const INIT_EXPO_LAYOUT_TEMPLATE = `import { DarkTheme, DefaultTheme, ThemeProvider } from '@react-navigation/native';
+import { Stack } from 'expo-router';
+import { StatusBar } from 'expo-status-bar';
+import { useColorScheme } from 'react-native';
+
+import { Providers } from '@/components/providers';
+
+export default function RootLayout() {
+  const colorScheme = useColorScheme();
+
+  return (
+    <ThemeProvider value={colorScheme === 'dark' ? DarkTheme : DefaultTheme}>
+      <Providers>
+        <Stack>
+          <Stack.Screen name="index" options={{ title: 'Messages' }} />
+        </Stack>
+        <StatusBar style={colorScheme === 'dark' ? 'light' : 'dark'} />
+      </Providers>
+    </ThemeProvider>
+  );
+}
+`;
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-messages-screen.template.ts
+const INIT_EXPO_MESSAGES_SCREEN_TEMPLATE = `import { useMutation, useQuery } from '@tanstack/react-query';
+import { useState } from 'react';
+import {
+  Pressable,
+  SafeAreaView,
+  ScrollView,
+  StyleSheet,
+  Text,
+  TextInput,
+  View,
+} from 'react-native';
+
+import { useCRPC } from '@/lib/convex/crpc';
+
+export default function MessagesScreen() {
+  const crpc = useCRPC();
+  const [draft, setDraft] = useState('');
+  const messagesQuery = useQuery(crpc.messages.list.queryOptions());
+  const createMessage = useMutation(crpc.messages.create.mutationOptions());
+
+  async function handleSubmit() {
+    const body = draft.trim();
+    if (!body || createMessage.isPending) return;
+
+    try {
+      await createMessage.mutateAsync({ body });
+      setDraft('');
+    } catch {}
+  }
+
+  return (
+    <SafeAreaView style={styles.safeArea}>
+      <ScrollView
+        contentContainerStyle={styles.content}
+        keyboardShouldPersistTaps="handled"
+      >
+        <View style={styles.header}>
+          <Text style={styles.kicker}>kitcn</Text>
+          <Text style={styles.title}>Messages</Text>
+          <Text style={styles.copy}>
+            This screen is a tiny live query and mutation over kitcn. Start the
+            backend, add a message, and watch the list update.
+          </Text>
+        </View>
+
+        <View style={styles.form}>
+          <TextInput
+            autoCapitalize="sentences"
+            maxLength={120}
+            onChangeText={setDraft}
+            placeholder="Write a message"
+            style={styles.input}
+            value={draft}
+          />
+          <Pressable
+            disabled={createMessage.isPending || draft.trim().length === 0}
+            onPress={() => {
+              void handleSubmit();
+            }}
+            style={[
+              styles.button,
+              (createMessage.isPending || draft.trim().length === 0) &&
+                styles.buttonDisabled,
+            ]}
+          >
+            <Text style={styles.buttonText}>
+              {createMessage.isPending ? 'Saving...' : 'Add message'}
+            </Text>
+          </Pressable>
+        </View>
+
+        {messagesQuery.isPending ? (
+          <Text style={styles.muted}>Loading messages...</Text>
+        ) : messagesQuery.isError ? (
+          <View style={styles.notice}>
+            <Text style={styles.noticeText}>
+              Backend not ready. Start kitcn dev and reload the app.
+            </Text>
+          </View>
+        ) : messagesQuery.data.length === 0 ? (
+          <View style={styles.notice}>
+            <Text style={styles.noticeText}>No messages yet. Add the first one.</Text>
+          </View>
+        ) : (
+          <View style={styles.list}>
+            {messagesQuery.data.map((message) => (
+              <View key={message.id} style={styles.card}>
+                <View style={styles.cardHeader}>
+                  <Text style={styles.cardBody}>{message.body}</Text>
+                  <Text style={styles.cardTime}>
+                    {message.createdAt.toLocaleTimeString([], {
+                      hour: '2-digit',
+                      minute: '2-digit',
+                    })}
+                  </Text>
+                </View>
+              </View>
+            ))}
+          </View>
+        )}
+      </ScrollView>
+    </SafeAreaView>
+  );
+}
+
+const styles = StyleSheet.create({
+  safeArea: {
+    flex: 1,
+    backgroundColor: '#ffffff',
+  },
+  content: {
+    gap: 20,
+    paddingHorizontal: 20,
+    paddingVertical: 24,
+  },
+  header: {
+    gap: 8,
+  },
+  kicker: {
+    color: '#6b7280',
+    fontSize: 12,
+    fontWeight: '600',
+    letterSpacing: 2,
+    textTransform: 'uppercase',
+  },
+  title: {
+    color: '#111827',
+    fontSize: 28,
+    fontWeight: '700',
+  },
+  copy: {
+    color: '#4b5563',
+    fontSize: 15,
+    lineHeight: 22,
+  },
+  form: {
+    gap: 12,
+  },
+  input: {
+    borderColor: '#d1d5db',
+    borderRadius: 12,
+    borderWidth: 1,
+    fontSize: 16,
+    minHeight: 48,
+    paddingHorizontal: 14,
+    paddingVertical: 12,
+  },
+  button: {
+    alignItems: 'center',
+    backgroundColor: '#111827',
+    borderRadius: 12,
+    minHeight: 48,
+    justifyContent: 'center',
+    paddingHorizontal: 16,
+  },
+  buttonDisabled: {
+    opacity: 0.5,
+  },
+  buttonText: {
+    color: '#ffffff',
+    fontSize: 15,
+    fontWeight: '600',
+  },
+  muted: {
+    color: '#6b7280',
+    fontSize: 14,
+  },
+  notice: {
+    borderColor: '#d1d5db',
+    borderRadius: 12,
+    borderStyle: 'dashed',
+    borderWidth: 1,
+    paddingHorizontal: 16,
+    paddingVertical: 18,
+  },
+  noticeText: {
+    color: '#4b5563',
+    fontSize: 14,
+    lineHeight: 20,
+  },
+  list: {
+    gap: 12,
+  },
+  card: {
+    backgroundColor: '#f9fafb',
+    borderColor: '#e5e7eb',
+    borderRadius: 12,
+    borderWidth: 1,
+    paddingHorizontal: 16,
+    paddingVertical: 14,
+  },
+  cardHeader: {
+    flexDirection: 'row',
+    gap: 12,
+    justifyContent: 'space-between',
+  },
+  cardBody: {
+    color: '#111827',
+    flex: 1,
+    fontSize: 15,
+    lineHeight: 22,
+  },
+  cardTime: {
+    color: '#6b7280',
+    fontSize: 12,
+    fontVariant: ['tabular-nums'],
+  },
+});
+`;
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-package-json.template.ts
+const INIT_EXPO_CODEGEN_SCRIPT = "kitcn codegen";
+const INIT_EXPO_PRIMARY_CODEGEN_SCRIPT_NAME = "codegen";
+const INIT_EXPO_FALLBACK_CODEGEN_SCRIPT_NAME = "convex:codegen";
+const INIT_EXPO_CONVEX_DEV_SCRIPT_NAME = "convex:dev";
+const INIT_EXPO_CONVEX_DEV_SCRIPT = "kitcn dev";
+const INIT_EXPO_CONVEX_TYPECHECK_SCRIPT_NAME = "typecheck:convex";
+const getInitExpoConvexTypecheckScript = (functionsDirRelative = "convex/functions") => `tsc --noEmit --project ${functionsDirRelative}/tsconfig.json`;
+const INIT_EXPO_PACKAGE_JSON_DEPENDENCIES = {
+	"@opentelemetry/api": SUPPORTED_DEPENDENCY_VERSIONS.opentelemetryApi.exact,
+	superjson: "2.2.6"
+};
+const INIT_EXPO_PACKAGE_JSON_DEV_DEPENDENCIES = { "@types/bun": "latest" };
+const getInitExpoPackageJsonDevDependencies = (options) => ({
+	...INIT_EXPO_PACKAGE_JSON_DEV_DEPENDENCIES,
+	...options.backend === "concave" ? { "@concavejs/cli": "latest" } : {}
+});
+function renderInitExpoPackageJsonTemplate(source, options = {}) {
+	const existing = source ? JSON.parse(source) : {};
+	const nextScripts = {
+		...existing.scripts,
+		typecheck: "tsc --noEmit && bun run typecheck:convex"
+	};
+	if (!nextScripts[INIT_EXPO_PRIMARY_CODEGEN_SCRIPT_NAME]) nextScripts[INIT_EXPO_PRIMARY_CODEGEN_SCRIPT_NAME] = INIT_EXPO_CODEGEN_SCRIPT;
+	else if (!nextScripts[INIT_EXPO_FALLBACK_CODEGEN_SCRIPT_NAME]) nextScripts[INIT_EXPO_FALLBACK_CODEGEN_SCRIPT_NAME] = INIT_EXPO_CODEGEN_SCRIPT;
+	if (!nextScripts[INIT_EXPO_CONVEX_DEV_SCRIPT_NAME]) nextScripts[INIT_EXPO_CONVEX_DEV_SCRIPT_NAME] = INIT_EXPO_CONVEX_DEV_SCRIPT;
+	if (!nextScripts[INIT_EXPO_CONVEX_TYPECHECK_SCRIPT_NAME]) nextScripts[INIT_EXPO_CONVEX_TYPECHECK_SCRIPT_NAME] = getInitExpoConvexTypecheckScript(options.functionsDirRelative);
+	return `${JSON.stringify({
+		...existing,
+		scripts: nextScripts,
+		dependencies: {
+			...existing.dependencies,
+			...INIT_EXPO_PACKAGE_JSON_DEPENDENCIES
+		},
+		devDependencies: {
+			...existing.devDependencies,
+			...getInitExpoPackageJsonDevDependencies(options)
+		}
+	}, null, 2)}\n`;
+}
+
+//#endregion
+//#region src/cli/registry/init/expo/init-expo-providers.template.ts
+const INIT_EXPO_PROVIDERS_TEMPLATE = `import type { ReactNode } from 'react';
+
+import { AppConvexProvider } from '@/lib/convex/convex-provider';
+
+export function Providers({ children }: { children: ReactNode }) {
+  return <AppConvexProvider>{children}</AppConvexProvider>;
+}
+`;
+
 //#endregion
 //#region src/cli/registry/init/init-convex-config.template.ts
 const INIT_CONVEX_CONFIG_TEMPLATE = `{
@@ -12667,6 +13476,8 @@ const LEADING_SLASHES_RE = /^\/+/;
 const AGGREGATE_STATE_RELATIVE_PATH = join(".convex", "kitcn", "aggregate-backfill-state.json");
 const AGGREGATE_STATE_VERSION = 1;
 const INIT_SHADCN_PACKAGE_SPEC = "shadcn@4.3.0";
+const INIT_EXPO_PACKAGE_SPEC = "create-expo-app@latest";
+const INIT_EXPO_TEMPLATE_SPEC = "default@sdk-55";
 const INIT_LOCAL_BOOTSTRAP_TIMEOUT_MS = 3e4;
 const LOCAL_BACKEND_NOT_RUNNING_RE = /Local backend isn't running/i;
 const INIT_GENERATED_SERVER_STUB_TEMPLATE = `// @ts-nocheck
@@ -12701,6 +13512,7 @@ const SUPPORTED_PLUGINS = new Set(getSupportedPluginKeys());
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const SUPPORTED_INIT_TEMPLATES = [
 	"next",
+	"expo",
 	"start",
 	"vite"
 ];
@@ -13096,6 +13908,38 @@ async function createProjectWithShadcn(params) {
 		});
 	}
 }
+async function createProjectWithExpo(params) {
+	const stagingRoot = fs.existsSync(params.projectDir) && fs.readdirSync(params.projectDir).length === 0 ? fs.mkdtempSync(join(dirname(params.projectDir), ".kitcn-expo-")) : null;
+	const expoCwd = stagingRoot ?? dirname(params.projectDir);
+	fs.mkdirSync(expoCwd, { recursive: true });
+	const projectName = basename(params.projectDir);
+	const command = detectPackageManager(expoCwd) === "bun" ? "bunx" : "npx";
+	const args = [
+		INIT_EXPO_PACKAGE_SPEC,
+		projectName,
+		"--template",
+		INIT_EXPO_TEMPLATE_SPEC,
+		"--no-install",
+		...params.yes ? ["--yes"] : []
+	];
+	try {
+		if (((await params.execaFn(command, args, {
+			cwd: expoCwd,
+			env: createCommandEnv(),
+			reject: false,
+			stdio: "inherit"
+		})).exitCode ?? 0) !== 0) throw new Error(`Expo init failed: ${command} ${args.join(" ")}`);
+		if (stagingRoot) moveStagedProjectIntoExistingDir({
+			stagedProjectDir: join(stagingRoot, projectName),
+			targetDir: params.projectDir
+		});
+	} finally {
+		if (stagingRoot) fs.rmSync(stagingRoot, {
+			recursive: true,
+			force: true
+		});
+	}
+}
 function buildMissingShadcnScaffoldMessage(projectDir) {
 	return [
 		"Shadcn exited without creating a supported local scaffold.",
@@ -13103,6 +13947,9 @@ function buildMissingShadcnScaffoldMessage(projectDir) {
 		`Run the generated shadcn command from ui.shadcn.com in ${normalizePath(relative(process.cwd(), projectDir) || ".")} then re-run \`kitcn init --yes\` to adopt it.`
 	].join(" ");
 }
+function buildMissingExpoScaffoldMessage(projectDir) {
+	return ["create-expo-app exited without creating a supported local scaffold.", `Re-run \`kitcn init -t expo --yes\` in ${normalizePath(relative(process.cwd(), projectDir) || ".")}, or try \`${INIT_EXPO_PACKAGE_SPEC} ${basename(projectDir)} --template ${INIT_EXPO_TEMPLATE_SPEC}\` directly.`].join(" ");
+}
 function moveStagedProjectIntoExistingDir(params) {
 	if (!fs.existsSync(params.stagedProjectDir)) throw new Error(buildMissingShadcnScaffoldMessage(params.targetDir));
 	if (!fs.existsSync(params.targetDir) || fs.readdirSync(params.targetDir).length > 0) throw new Error(`Cannot move staged project into non-empty target ${params.targetDir}.`);
@@ -13254,6 +14101,137 @@ function buildInitNextOwnedScaffoldFiles(context, functionsDirRelative, backend,
 	});
 	return files;
 }
+function buildInitExpoOwnedScaffoldFiles(context, functionsDirRelative, backend, includeDemoFiles) {
+	const files = [
+		{
+			kind: "config",
+			relativePath: "package.json",
+			requiresExplicitOverwrite: false,
+			content: ({ existingContent }) => renderInitExpoPackageJsonTemplate(existingContent, {
+				backend,
+				functionsDirRelative
+			}),
+			createReason: "Create baseline package.json scripts for the Expo scaffold.",
+			updateReason: "Update package.json scripts for the Expo scaffold.",
+			skipReason: "package.json scripts already match the Expo scaffold."
+		},
+		{
+			kind: "env",
+			relativePath: ".env.local",
+			requiresExplicitOverwrite: false,
+			content: ({ existingContent }) => renderInitExpoEnvTemplate(existingContent),
+			createReason: "Create baseline .env.local for the Expo scaffold.",
+			updateReason: "Update baseline .env.local for the Expo scaffold.",
+			skipReason: ".env.local already matches the Expo scaffold."
+		},
+		{
+			kind: "config",
+			relativePath: "expo-env.d.ts",
+			requiresExplicitOverwrite: true,
+			content: INIT_EXPO_ENV_TYPES_TEMPLATE,
+			createReason: "Create expo-env.d.ts for the Expo scaffold.",
+			updateReason: "Update expo-env.d.ts for the Expo scaffold.",
+			skipReason: "expo-env.d.ts already matches the Expo scaffold."
+		},
+		{
+			kind: "config",
+			relativePath: ".gitignore",
+			requiresExplicitOverwrite: false,
+			content: ({ existingContent }) => renderInitExpoGitignoreTemplate(existingContent ?? ""),
+			createReason: "Create .gitignore for the Expo scaffold.",
+			updateReason: "Update .gitignore so the Expo scaffold keeps expo-env.d.ts tracked.",
+			skipReason: ".gitignore already matches the Expo scaffold."
+		},
+		{
+			kind: "scaffold",
+			relativePath: `${context.componentsDir}/providers.tsx`,
+			requiresExplicitOverwrite: true,
+			content: INIT_EXPO_PROVIDERS_TEMPLATE,
+			createReason: `Create baseline ${context.componentsDir}/providers.tsx for the Expo scaffold.`,
+			updateReason: `Update ${context.componentsDir}/providers.tsx for the Expo scaffold.`,
+			skipReason: `${context.componentsDir}/providers.tsx already matches the Expo scaffold.`
+		},
+		{
+			kind: "scaffold",
+			relativePath: `${context.convexClientDir}/query-client.ts`,
+			requiresExplicitOverwrite: true,
+			content: INIT_NEXT_QUERY_CLIENT_TEMPLATE,
+			createReason: `Create baseline ${context.convexClientDir}/query-client.ts for the Expo scaffold.`,
+			updateReason: `Update ${context.convexClientDir}/query-client.ts for the Expo scaffold.`,
+			skipReason: `${context.convexClientDir}/query-client.ts already matches the Expo scaffold.`
+		},
+		{
+			kind: "scaffold",
+			relativePath: `${context.convexClientDir}/crpc.tsx`,
+			requiresExplicitOverwrite: true,
+			content: INIT_EXPO_CRPC_TEMPLATE,
+			createReason: `Create baseline ${context.convexClientDir}/crpc.tsx for the Expo scaffold.`,
+			updateReason: `Update ${context.convexClientDir}/crpc.tsx for the Expo scaffold.`,
+			skipReason: `${context.convexClientDir}/crpc.tsx already matches the Expo scaffold.`
+		},
+		{
+			kind: "scaffold",
+			relativePath: `${context.convexClientDir}/convex-provider.tsx`,
+			requiresExplicitOverwrite: true,
+			content: INIT_EXPO_CONVEX_PROVIDER_TEMPLATE,
+			createReason: `Create baseline ${context.convexClientDir}/convex-provider.tsx for the Expo scaffold.`,
+			updateReason: `Update ${context.convexClientDir}/convex-provider.tsx for the Expo scaffold.`,
+			skipReason: `${context.convexClientDir}/convex-provider.tsx already matches the Expo scaffold.`
+		},
+		{
+			kind: "config",
+			relativePath: join(functionsDirRelative, "tsconfig.json"),
+			managedBaselineContent: getManagedConvexTsconfigBaselines(functionsDirRelative),
+			requiresExplicitOverwrite: true,
+			content: ({ existingContent }) => typeof existingContent === "string" ? patchInitConvexTsconfigContent(existingContent, functionsDirRelative) : renderInitConvexTsconfigTemplate(functionsDirRelative),
+			createReason: `Create ${join(functionsDirRelative, "tsconfig.json")} for kitcn functions.`,
+			updateReason: `Patch ${join(functionsDirRelative, "tsconfig.json")} for kitcn functions.`,
+			skipReason: `${join(functionsDirRelative, "tsconfig.json")} already matches the kitcn functions project.`
+		}
+	];
+	if (includeDemoFiles) files.push({
+		kind: "scaffold",
+		relativePath: `${context.appDir}/_layout.tsx`,
+		requiresExplicitOverwrite: true,
+		content: INIT_EXPO_LAYOUT_TEMPLATE,
+		createReason: `Create ${context.appDir}/_layout.tsx for the Expo scaffold.`,
+		updateReason: `Update ${context.appDir}/_layout.tsx for the Expo scaffold.`,
+		skipReason: `${context.appDir}/_layout.tsx already matches the Expo scaffold.`
+	}, {
+		kind: "scaffold",
+		relativePath: `${context.appDir}/index.tsx`,
+		requiresExplicitOverwrite: true,
+		content: INIT_EXPO_MESSAGES_SCREEN_TEMPLATE,
+		createReason: `Create ${context.appDir}/index.tsx as the minimal kitcn demo route.`,
+		updateReason: `Update ${context.appDir}/index.tsx for the kitcn demo route.`,
+		skipReason: `${context.appDir}/index.tsx already matches the kitcn demo route.`
+	}, {
+		kind: "scaffold",
+		relativePath: `${context.appDir}/explore.tsx`,
+		requiresExplicitOverwrite: true,
+		content: INIT_EXPO_EXPLORE_TEMPLATE,
+		createReason: `Create ${context.appDir}/explore.tsx as a redirect back to the kitcn demo route.`,
+		updateReason: `Update ${context.appDir}/explore.tsx as a redirect back to the kitcn demo route.`,
+		skipReason: `${context.appDir}/explore.tsx already redirects to the kitcn demo route.`
+	}, {
+		kind: "schema",
+		relativePath: `${functionsDirRelative}/schema.ts`,
+		requiresExplicitOverwrite: true,
+		content: INIT_NEXT_SCHEMA_TEMPLATE,
+		createReason: `Create ${functionsDirRelative}/schema.ts with the minimal kitcn demo schema.`,
+		updateReason: `Update ${functionsDirRelative}/schema.ts with the minimal kitcn demo schema.`,
+		skipReason: `${functionsDirRelative}/schema.ts already matches the kitcn demo schema.`
+	}, {
+		kind: "scaffold",
+		relativePath: `${functionsDirRelative}/messages.ts`,
+		requiresExplicitOverwrite: true,
+		content: renderInitNextMessagesTemplate(functionsDirRelative),
+		createReason: `Create ${functionsDirRelative}/messages.ts for the kitcn demo route.`,
+		updateReason: `Update ${functionsDirRelative}/messages.ts for the kitcn demo route.`,
+		skipReason: `${functionsDirRelative}/messages.ts already matches the kitcn demo route.`
+	});
+	return files;
+}
 function buildInitReactOwnedScaffoldFiles(context, functionsDirRelative, backend) {
 	return [
 		{
@@ -13661,6 +14639,19 @@ function buildInitNextLayoutPlanFile(context) {
 		skipReason: `${context.appDir}/layout.tsx already mounts Providers.`
 	});
 }
+function buildInitExpoTsconfigPlanFile(context) {
+	const filePath = resolve(process.cwd(), "tsconfig.json");
+	if (!fs.existsSync(filePath)) throw new Error("Could not patch tsconfig.json: the Expo scaffold did not create a tsconfig file.");
+	return createPlanFile({
+		kind: "config",
+		filePath,
+		requiresExplicitOverwrite: false,
+		content: patchInitTsconfigContent(fs.readFileSync(filePath, "utf8"), context),
+		updateReason: "Patch tsconfig.json to keep the Expo alias and add @convex/*.",
+		createReason: "Patch tsconfig.json to keep the Expo alias and add @convex/*.",
+		skipReason: "tsconfig.json already includes the kitcn alias."
+	});
+}
 function buildInitNextTsconfigPlanFile(context) {
 	const filePath = resolve(process.cwd(), "tsconfig.json");
 	if (!fs.existsSync(filePath)) throw new Error("Could not patch tsconfig.json: shadcn did not create a tsconfig file.");
@@ -13773,7 +14764,7 @@ function buildTemplateInitializationPlanFiles(params) {
 		allowUnsupported: true
 	});
 	if (!projectContext) return [];
-	const plannedOwnedFiles = (projectContext.mode === "next-app" ? buildInitNextOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend, params.includeDemoFiles) : projectContext.framework === "tanstack-start" ? buildInitStartOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend, params.includeDemoFiles) : buildInitReactOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend)).map((file) => {
+	const plannedOwnedFiles = (projectContext.mode === "next-app" ? buildInitNextOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend, params.includeDemoFiles) : projectContext.framework === "expo" ? buildInitExpoOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend, params.includeDemoFiles) : projectContext.framework === "tanstack-start" ? buildInitStartOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend, params.includeDemoFiles) : buildInitReactOwnedScaffoldFiles(projectContext, params.functionsDirRelative, params.backend)).map((file) => {
 		const filePath = resolve(process.cwd(), file.relativePath);
 		const existingContent = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : void 0;
 		const nextContent = typeof file.content === "function" ? file.content({ existingContent }) : file.content;
@@ -13803,6 +14794,7 @@ function buildTemplateInitializationPlanFiles(params) {
 			buildInitNextLayoutPlanFile(projectContext)
 		];
 	}
+	if (projectContext.framework === "expo") return [...plannedOwnedFiles, buildInitExpoTsconfigPlanFile(projectContext)];
 	if (projectContext.framework === "tanstack-start") return [
 		...plannedOwnedFiles,
 		buildInitReactRootTsconfigPlanFile(projectContext),
@@ -14031,7 +15023,12 @@ async function withWorkingDirectory(cwd, fn) {
 	}
 }
 async function runScaffoldCommandFlow(params) {
-	if (params.template) await createProjectWithShadcn({
+	if (params.template) if (params.template === "expo") await createProjectWithExpo({
+		projectDir: params.projectDir,
+		yes: params.yes,
+		execaFn: params.execaFn
+	});
+	else await createProjectWithShadcn({
 		projectDir: params.projectDir,
 		template: params.template,
 		yes: params.yes,
@@ -14043,7 +15040,7 @@ async function runScaffoldCommandFlow(params) {
 		cwd: scaffoldProjectDir,
 		allowMissing: true,
 		allowUnsupported: true
-	})) throw new Error(buildMissingShadcnScaffoldMessage(scaffoldProjectDir));
+	})) throw new Error(params.template === "expo" ? buildMissingExpoScaffoldMessage(scaffoldProjectDir) : buildMissingShadcnScaffoldMessage(scaffoldProjectDir));
 	return withWorkingDirectory(scaffoldProjectDir, async () => {
 		const config = params.loadCliConfigFn(params.configPath);
 		const backend = resolveConfiguredBackend({
@@ -14109,7 +15106,7 @@ async function runInitCommandFlow(params) {
 		allowUnsupported: true
 	});
 	if (template !== void 0 || params.initArgs.defaults || params.initArgs.name !== void 0) {
-		if (!template) throw new Error("Fresh app scaffolding requires `kitcn init -t <next|start|vite>`.");
+		if (!template) throw new Error("Fresh app scaffolding requires `kitcn init -t <next|expo|start|vite>`.");
 		if (existingProjectContext) throw new Error(`Existing supported app scaffold detected. Run \`kitcn init --yes\` in ${normalizePath(relative(process.cwd(), projectDir) || ".")} to adopt the current project.`);
 		return runScaffoldCommandFlow({
 			allowCodegenBootstrapFallback: !params.initArgs.json,
@@ -14131,7 +15128,8 @@ async function runInitCommandFlow(params) {
 			realConcavePath: params.realConcavePath
 		});
 	}
-	if (!existingProjectContext) throw new Error("Could not detect a supported app scaffold. Use `kitcn init -t <next|start|vite>` for a fresh app.");
+	if (existingProjectContext?.framework === "expo") throw new Error("Expo adoption is not supported yet. Start with `kitcn init -t expo --yes`.");
+	if (!existingProjectContext) throw new Error("Could not detect a supported app scaffold. Use `kitcn init -t <next|expo|start|vite>` for a fresh app.");
 	return runScaffoldCommandFlow({
 		allowCodegenBootstrapFallback: !params.initArgs.json,
 		projectDir,
@@ -15299,8 +16297,11 @@ async function runAggregateBackfillFlow(params) {
 	return 0;
 }
 async function runAggregatePruneFlow(params) {
-	const { execaFn, backendAdapter, targetArgs } = params;
-	const result = await runBackendFunction(execaFn, backendAdapter, "generated/server:aggregateBackfill", { mode: "prune" }, targetArgs, { echoOutput: false });
+	const { execaFn, backendAdapter, targetArgs, env } = params;
+	const result = await runBackendFunction(execaFn, backendAdapter, "generated/server:aggregateBackfill", { mode: "prune" }, targetArgs, {
+		echoOutput: false,
+		env
+	});
 	if (result.exitCode !== 0) return result.exitCode;
 	const payload = parseBackendRunJson(result.stdout);
 	const pruned = typeof payload === "object" && payload !== null && !Array.isArray(payload) && typeof payload.pruned === "number" ? payload.pruned : 0;