@terreno/mcp 57.2.0 → 57.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @terreno/mcp
 
-MCP (Model Context Protocol) server for Terreno. Provides documentation, tools, and prompts for building full-stack applications with Terreno packages.
+MCP server for Terreno - provides documentation, tools, and prompts for building full-stack apps.
 
 ## Features
 
@@ -18,6 +18,9 @@ Documentation resources accessible via MCP:
 
 Code generation tools:
 
+- `terreno_search_docs` - Search bundled Terreno documentation (call before guessing APIs). Optional `version` selects a retained docs snapshot; omit for current `next` docs.
+- `terreno_get_component_docs` - Full `@terreno/ui` props table for one component
+- `terreno_get_upgrade_guide` - Lockstep upgrade notes between two `@terreno/*` versions
 - `terreno_bootstrap_app` - Scaffold a new full-stack Terreno app (frontend, backend, rules, MCP)
 - `terreno_bootstrap_ai_rules` - Scaffold AI assistant rules files for Cursor, Claude Code, etc.
 - `terreno_generate_model` - Generate a Mongoose model with proper Terreno conventions
@@ -39,8 +42,9 @@ Code generation prompts:
 - `terreno_add_authentication` - Generate authentication setup
 - `terreno_migrate_to_terreno_app` - Migrate from setupServer to TerrenoApp pattern
 - `terreno_style_guide` - Get the Terreno code style guide
+- `terreno_upgrade` - Lockstep Terreno upgrade workflow
 
-## Installation
+## Install
 
 ```bash
 # From the monorepo root
@@ -265,3 +269,11 @@ This will generate a comprehensive prompt with instructions for creating:
 - Backend model with proper schema
 - API routes with permissions
 - Frontend list, detail, and form screens
+
+## Documentation
+
+Full API reference: [docs/reference/mcp-server.md](https://github.com/flourishhealth/terreno/blob/master/docs/reference/mcp-server.md)
+
+## License and Contributing
+
+Licensed under the [MIT License](https://github.com/flourishhealth/terreno/blob/master/LICENSE). See [CONTRIBUTING.md](https://github.com/flourishhealth/terreno/blob/master/CONTRIBUTING.md) for contribution guidelines.

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAUvD,8FAA8F;AAC9F,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,IAAI,EA4DhC,CAAC;AAEF,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA41ED,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CA4E/C,CAAC;AAqIF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CA4H/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CAiEzE,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAUvD,8FAA8F;AAC9F,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,IAAI,EA4DhC,CAAC;AAEF,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA0iFD,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CA4E/C,CAAC;AAuJF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAmH/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CAgEzE,CAAC"}

package/dist/bootstrap.js

@@ -245,6 +245,7 @@ const generateBackendPackageJson = (args) => {
             lint: "biome check .",
             "lint:fix": "biome check --write .",
             "lint:unsafefix": "biome check --write . --unsafe",
+            seed: "bun run src/scripts/seed.ts",
             start: "bun run src/index.ts",
             test: "bun test",
         },
@@ -488,6 +489,107 @@ export const connectToMongoDB = async (): Promise<void> => {
 };
 `;
 };
+const generateBackendSeed = () => {
+    return `import {
+  APIError,
+  createBetterAuth,
+  getMongoClientFromMongoose,
+  logger,
+  runSeedCli,
+  seedBetterAuthUser,
+  type SeedStep,
+  type UserModel as TerrenoAuthUserModel,
+} from "@terreno/api";
+import mongoose from "mongoose";
+
+import {User} from "../models/user";
+import {buildBetterAuthConfig} from "../utils/betterAuthConfig";
+import {connectToMongoDB} from "../utils/database";
+
+const SEED_USERS = [
+  {
+    admin: false,
+    email: "test@example.com",
+    name: "Test User",
+    password: "testpassword123",
+  },
+  {
+    admin: true,
+    email: "admin@example.com",
+    name: "Admin User",
+    password: "testpassword123",
+  },
+];
+
+const seedSteps: SeedStep[] = [
+  {
+    description: "Create login-ready development users and reconcile profile fields",
+    name: "users",
+    run: async (context) => {
+      if (context.dryRun) {
+        for (const user of SEED_USERS) {
+          const existing = await User.findByEmail(user.email);
+          context.changes.push({
+            change: existing ? "updated" : "created",
+            count: 1,
+            key: JSON.stringify({email: user.email}),
+            model: User.modelName,
+          });
+        }
+        return;
+      }
+
+      const config = buildBetterAuthConfig();
+      if (!config) {
+        throw new APIError({
+          status: 500,
+          title: "Seed users require Better Auth to be enabled",
+        });
+      }
+      const auth = createBetterAuth({
+        config,
+        mongoClient: getMongoClientFromMongoose(),
+        userModel: User as unknown as TerrenoAuthUserModel,
+      });
+      for (const definition of SEED_USERS) {
+        const user = await seedBetterAuthUser({
+          auth,
+          user: definition,
+          userModel: User as unknown as TerrenoAuthUserModel,
+        });
+        const appUser = user as unknown as {
+          admin: boolean;
+          save: () => Promise<unknown>;
+        };
+        appUser.admin = definition.admin;
+        await appUser.save();
+      }
+    },
+  },
+];
+
+const main = async (): Promise<void> => {
+  const cli = await runSeedCli({
+    allowProductionReset: () => process.env.ALLOW_SEED_RESET === "true",
+    connect: connectToMongoDB,
+    disconnect: async () => {
+      await mongoose.disconnect();
+    },
+    name: "bun run seed",
+    steps: seedSteps,
+  });
+  if (cli.help) {
+    logger.info(cli.help);
+  }
+  process.exit(cli.exitCode);
+};
+
+main().catch((error: unknown) => {
+  logger.error(\`Seed failed: \${error}\`);
+  process.exit(1);
+});
+`;
+};
 const generateBackendBetterAuthConfig = (args) => {
     const { appName } = args;
     return `import type {AuthProvider, BetterAuthConfig} from "@terreno/api";
@@ -749,6 +851,9 @@ const generateFrontendPackageJson = (args) => {
     const { appName } = args;
     return JSON.stringify({
         dependencies: {
+            "@expo/vector-icons": "^15.1.1",
+            "@react-native-async-storage/async-storage": "2.2.0",
+            "@reduxjs/toolkit": "^2.11.1",
             "@sentry/react": "^10.29.0",
             "@terreno/admin-frontend": "latest",
             "@terreno/rtk": "latest",
@@ -758,15 +863,23 @@ const generateFrontendPackageJson = (args) => {
             "expo-constants": "~18.0.13",
             "expo-router": "~57.0.14",
             "expo-sqlite": "~16.0.10",
+            lodash: "^4.18.1",
+            luxon: "^3.7.2",
             react: "19.2.3",
             "react-dom": "19.2.3",
             "react-native": "0.86.2",
+            "react-native-reanimated": "4.5.1",
             "react-redux": "^9.2.0",
+            "redux-persist": "^6.0.0",
         },
         devDependencies: {
             "@biomejs/biome": "^2.3.6",
             "@playwright/test": "^1.58.2",
+            "@rtk-query/codegen-openapi": "^2.2.0",
+            "@types/lodash": "^4.17.17",
+            "@types/luxon": "^3.7.1",
             "@types/react": "~19.2.14",
+            tsx: "^4.23.12",
             typescript: "~6.0.3",
         },
         main: "expo-router/entry",
@@ -774,6 +887,7 @@ const generateFrontendPackageJson = (args) => {
         private: true,
         scripts: {
             android: "EXPO_UNSTABLE_MCP_SERVER=1 bun expo start --android --port 8082",
+            compile: "tsc",
             ios: "EXPO_UNSTABLE_MCP_SERVER=1 bun expo start --ios --port 8082",
             lint: "bun biome check .",
             "lint:fix": "bun biome check --write .",
@@ -789,17 +903,13 @@ const generateFrontendPackageJson = (args) => {
 const generateFrontendAppJson = (args) => {
     const { appDisplayName, appName } = args;
     return JSON.stringify({
+        // No icon/splash/favicon keys: Expo falls back to its built-in defaults, so a freshly
+        // generated app bundles without any binary assets. Add your own branding later and
+        // point `icon`, `android.adaptiveIcon`, `splash`, and `web.favicon` at those files.
         expo: {
-            android: {
-                adaptiveIcon: {
-                    backgroundColor: "#ffffff",
-                    foregroundImage: "./assets/images/adaptive-icon.png",
-                },
-            },
             experiments: {
                 typedRoutes: true,
             },
-            icon: "./assets/images/icon.png",
             ios: {
                 supportsTablet: true,
             },
@@ -808,27 +918,22 @@ const generateFrontendAppJson = (args) => {
             plugins: ["expo-router"],
             scheme: appName,
             slug: appName,
-            splash: {
-                backgroundColor: "#ffffff",
-                image: "./assets/images/splash-icon.png",
-                resizeMode: "contain",
-            },
             userInterfaceStyle: "automatic",
             version: "1.0.0",
             web: {
                 bundler: "metro",
-                favicon: "./assets/images/favicon.png",
                 output: "static",
             },
         },
     }, null, 2);
 };
 const generateFrontendTsConfig = () => {
+    // No `baseUrl`: it is deprecated as of TypeScript 6 and makes `tsc` abort with TS5101
+    // before checking a single file. `paths` entries are relative to this tsconfig instead.
     return JSON.stringify({
         compilerOptions: {
             allowJs: true,
             allowSyntheticDefaultImports: true,
-            baseUrl: ".",
             esModuleInterop: true,
             jsx: "react-jsx",
             lib: ["DOM", "ESNext"],
@@ -853,6 +958,44 @@ const generateFrontendTsConfig = () => {
         include: ["**/*.ts", "**/*.tsx", ".expo/types/**/*.ts", "expo-env.d.ts"],
     }, null, 2);
 };
+const generateFrontendMetroConfig = () => {
+    return `const {getDefaultConfig} = require("expo/metro-config");
+const path = require("path");
+
+const config = getDefaultConfig(__dirname);
+
+const defaultResolveRequest = config.resolver.resolveRequest;
+
+config.resolver.resolveRequest = (context, moduleName, platform) => {
+  // @terreno/admin-frontend imports jspdf for its consent-PDF export. jspdf's CommonJS and
+  // Node builds wrap an AMD-style \`require(["html2canvas"], cb)\` call that Metro's static
+  // transform cannot parse, which fails the whole bundle — including Expo Router's static
+  // web render, which resolves under a "node" condition and would otherwise pick
+  // jspdf.node.min.js. Pin every jspdf request to the ESM browser build on web, and drop it
+  // on native, where PDF export is unavailable and jspdf's browser/Node APIs are missing.
+  if (moduleName === "jspdf" || moduleName.startsWith("jspdf/dist/jspdf.node")) {
+    if (platform !== "web") {
+      return {type: "empty"};
+    }
+    try {
+      const jspdfDir = path.dirname(require.resolve("jspdf/package.json", {paths: [__dirname]}));
+      return {
+        filePath: path.join(jspdfDir, "dist", "jspdf.es.min.js"),
+        type: "sourceFile",
+      };
+    } catch {
+      // jspdf is not installed — let Metro report the failure itself.
+    }
+  }
+
+  return defaultResolveRequest
+    ? defaultResolveRequest(context, moduleName, platform)
+    : context.resolveRequest(context, moduleName, platform);
+};
+
+module.exports = config;
+`;
+};
 const generateFrontendTsConfigCodegen = () => {
     return JSON.stringify({
         compilerOptions: {
@@ -1020,11 +1163,8 @@ exec(command, (error, _stdout, stderr) => {
 `;
 };
 const generateFrontendRootLayout = (_args) => {
-    return `import FontAwesome from "@expo/vector-icons/FontAwesome";
-import {DefaultTheme, ThemeProvider} from "expo-router/react-navigation";
-import {useFonts} from "expo-font";
+    return `import {DefaultTheme, ThemeProvider} from "expo-router/react-navigation";
 import {Stack} from "expo-router";
-import * as SplashScreen from "expo-splash-screen";
 import {useEffect} from "react";
 import "react-native-reanimated";
 import {baseUrl, selectBetterAuthIsLoading, selectBetterAuthUserId} from "@terreno/rtk";
@@ -1041,32 +1181,9 @@ export const unstable_settings = {
   initialRouteName: "(tabs)",
 };
 
-SplashScreen.preventAutoHideAsync();
-
+// TerrenoProvider loads the Nunito/Titillium Web families @terreno/ui renders with, so this
+// app ships no font assets of its own. Add \`useFonts\` here only for extra custom faces.
 export default function RootLayout(): React.ReactElement | null {
-  const [loaded, error] = useFonts({
-    SpaceMono: require("../assets/fonts/SpaceMono-Regular.ttf"),
-    ...FontAwesome.font,
-  });
-
-  // Handle font loading errors
-  useEffect(() => {
-    if (error) {
-      throw error;
-    }
-  }, [error]);
-
-  // Hide splash screen when fonts are loaded
-  useEffect(() => {
-    if (loaded) {
-      SplashScreen.hideAsync();
-    }
-  }, [loaded]);
-
-  if (!loaded) {
-    return null;
-  }
-
   return (
     <Provider store={store}>
       <PersistGate loading={null} persistor={persistor}>
@@ -1119,15 +1236,17 @@ function RootLayoutNav(): React.ReactElement {
   return (
     <SyncDbProvider client={syncDb}>
       <ThemeProvider value={DefaultTheme}>
+        {/* Stack.Protected is the supported way to gate routes on auth state. Rendering
+            Stack.Screen children behind a raw conditional (or a fragment) crashes the
+            navigator, because Stack reads its screen config off the child elements. */}
         <Stack>
-          {!userId ? (
-            <>
-              <Stack.Screen name="login" options={{headerShown: false}} />
-              <Stack.Screen name="signup" options={{headerShown: false}} />
-            </>
-          ) : (
+          <Stack.Protected guard={!userId}>
+            <Stack.Screen name="login" options={{headerShown: false}} />
+            <Stack.Screen name="signup" options={{headerShown: false}} />
+          </Stack.Protected>
+          <Stack.Protected guard={Boolean(userId)}>
             <Stack.Screen name="(tabs)" options={{headerShown: false}} />
-          )}
+          </Stack.Protected>
         </Stack>
       </ThemeProvider>
     </SyncDbProvider>
@@ -1319,16 +1438,39 @@ export default HomeScreen;
 `;
 };
 const generateFrontendTabsProfile = () => {
-    return `import {Box, Button, Heading, Page, Text} from "@terreno/ui";
+    return `import {Box, Button, Card, Heading, Page, Spinner, TapToEdit, Text} from "@terreno/ui";
 import type React from "react";
-import {useCallback} from "react";
+import {useCallback, useEffect, useState} from "react";
 import {signOut} from "@/lib/betterAuth";
 import {logout, syncBetterAuthSession, useAppDispatch} from "@/store/index";
-import {useGetMeQuery} from "@/store/sdk";
+import {useGetMeQuery, usePatchMeMutation} from "@/store/sdk";
 
 const ProfileScreen: React.FC = () => {
   const dispatch = useAppDispatch();
   const {data: profile, isLoading} = useGetMeQuery();
+  const [updateProfile] = usePatchMeMutation();
+  const [name, setName] = useState<string>("");
+  const [email, setEmail] = useState<string>("");
+  const [password, setPassword] = useState<string>("");
+  const [saveError, setSaveError] = useState<string | null>(null);
+
+  const user = profile?.data;
+
+  // Copy the server name into local state without resetting an in-progress email edit.
+  useEffect(() => {
+    if (!user) {
+      return;
+    }
+    setName(user.name || "");
+  }, [user?.name]);
+
+  // Copy the server email into local state without resetting an in-progress name edit.
+  useEffect(() => {
+    if (!user) {
+      return;
+    }
+    setEmail(user.email || "");
+  }, [user?.email]);
 
   const handleLogout = useCallback(async (): Promise<void> => {
     await signOut();
@@ -1336,30 +1478,92 @@ const ProfileScreen: React.FC = () => {
     await syncBetterAuthSession(dispatch);
   }, [dispatch]);
 
+  const handleSaveName = useCallback(
+    async (value: string): Promise<void> => {
+      setSaveError(null);
+      try {
+        await updateProfile({name: value}).unwrap();
+      } catch (err) {
+        console.error("Error updating name:", err);
+        setSaveError("Failed to update name");
+      }
+    },
+    [updateProfile]
+  );
+
+  const handleSaveEmail = useCallback(
+    async (value: string): Promise<void> => {
+      setSaveError(null);
+      try {
+        await updateProfile({email: value}).unwrap();
+      } catch (err) {
+        console.error("Error updating email:", err);
+        setSaveError("Failed to update email");
+      }
+    },
+    [updateProfile]
+  );
+
+  const handleSavePassword = useCallback(
+    async (value: string): Promise<void> => {
+      if (!value) {
+        return;
+      }
+      setSaveError(null);
+      try {
+        await updateProfile({password: value}).unwrap();
+        setPassword("");
+      } catch (err) {
+        console.error("Error updating password:", err);
+        setSaveError("Failed to update password");
+      }
+    },
+    [updateProfile]
+  );
+
   if (isLoading) {
     return (
       <Page navigation={undefined} title="Profile">
-        <Box padding={4}>
-          <Text>Loading...</Text>
+        <Box alignItems="center" flex="grow" justifyContent="center" padding={4}>
+          <Spinner />
         </Box>
       </Page>
     );
   }
 
   return (
-    <Page navigation={undefined} title="Profile">
-      <Box padding={4} gap={4}>
+    <Page navigation={undefined} scroll title="Profile">
+      <Box gap={4} padding={4}>
         <Heading>Profile</Heading>
-        <Box gap={2}>
-          <Text weight="bold">Name</Text>
-          <Text>{profile?.data?.name || "Not set"}</Text>
-        </Box>
-        <Box gap={2}>
-          <Text weight="bold">Email</Text>
-          <Text>{profile?.data?.email || "Not set"}</Text>
-        </Box>
+        <Card>
+          <Box gap={4}>
+            <TapToEdit
+              onSave={handleSaveName}
+              setValue={setName}
+              title="Name"
+              type="text"
+              value={name}
+            />
+            <TapToEdit
+              onSave={handleSaveEmail}
+              setValue={setEmail}
+              title="Email"
+              type="email"
+              value={email}
+            />
+            <TapToEdit
+              helperText="Leave blank to keep your current password"
+              onSave={handleSavePassword}
+              setValue={setPassword}
+              title="New Password"
+              type="password"
+              value={password}
+            />
+            {saveError && <Text color="error">{saveError}</Text>}
+          </Box>
+        </Card>
         <Box marginTop={4}>
-          <Button onClick={handleLogout} text="Logout" variant="outline" fullWidth />
+          <Button fullWidth onClick={handleLogout} text="Logout" variant="outline" />
         </Box>
       </Box>
     </Page>
@@ -2452,6 +2656,21 @@ jobs:
           CI: true
 `;
 };
+const getFenceLanguage = (filePath) => {
+    if (filePath.endsWith(".json") || filePath.endsWith(".jsonc")) {
+        return "json";
+    }
+    if (filePath.endsWith(".js")) {
+        return "javascript";
+    }
+    if (filePath.endsWith(".yml") || filePath.endsWith(".yaml")) {
+        return "yaml";
+    }
+    if (filePath.endsWith(".md")) {
+        return "markdown";
+    }
+    return "typescript";
+};
 const generateAllFiles = (args) => {
     const frontendDir = `frontend`;
     const backendDir = `backend`;
@@ -2468,6 +2687,7 @@ const generateAllFiles = (args) => {
         { content: generateBackendIndex(), path: `${backendDir}/src/index.ts` },
         { content: generateBackendServer(args), path: `${backendDir}/src/server.ts` },
         { content: generateBackendDatabase(args), path: `${backendDir}/src/utils/database.ts` },
+        { content: generateBackendSeed(), path: `${backendDir}/src/scripts/seed.ts` },
         {
             content: generateBackendBetterAuthConfig(args),
             path: `${backendDir}/src/utils/betterAuthConfig.ts`,
@@ -2489,6 +2709,7 @@ const generateAllFiles = (args) => {
         { content: generateFrontendAppJson(args), path: `${frontendDir}/app.json` },
         { content: generateFrontendTsConfig(), path: `${frontendDir}/tsconfig.json` },
         { content: generateFrontendTsConfigCodegen(), path: `${frontendDir}/tsconfig.codegen.json` },
+        { content: generateFrontendMetroConfig(), path: `${frontendDir}/metro.config.js` },
         { content: generateFrontendBiomeJsonc(), path: `${frontendDir}/biome.jsonc` },
         { content: generateFrontendOpenApiConfig(), path: `${frontendDir}/openapi-config.ts` },
         { content: generateFrontendGenerateSdk(), path: `${frontendDir}/scripts/generate-sdk.ts` },
@@ -2560,52 +2781,43 @@ ${fileList}
 
 2. **Create all the files listed above.** Each file's content is provided below.
 
-3. **Create asset directories and download assets from Expo:**
-   \`\`\`bash
-   mkdir -p frontend/assets/fonts
-   mkdir -p frontend/assets/images
-
-   # Download SpaceMono font
-   curl -L -o frontend/assets/fonts/SpaceMono-Regular.ttf \\
-     "https://github.com/expo/expo/raw/main/templates/expo-template-blank-typescript/assets/fonts/SpaceMono-Regular.ttf"
-
-   # Download Expo default images
-   curl -L -o frontend/assets/images/icon.png \\
-     "https://github.com/expo/expo/raw/main/templates/expo-template-blank-typescript/assets/images/icon.png"
-   curl -L -o frontend/assets/images/splash-icon.png \\
-     "https://github.com/expo/expo/raw/main/templates/expo-template-blank-typescript/assets/images/splash-icon.png"
-   curl -L -o frontend/assets/images/adaptive-icon.png \\
-     "https://github.com/expo/expo/raw/main/templates/expo-template-blank-typescript/assets/images/adaptive-icon.png"
-   curl -L -o frontend/assets/images/favicon.png \\
-     "https://github.com/expo/expo/raw/main/templates/expo-template-blank-typescript/assets/images/favicon.png"
-   \`\`\`
+   No \`assets/\` directory is needed: \`@terreno/ui\` ships the Nunito and Titillium Web
+   fonts it renders with, and \`app.json\` leaves \`icon\`/\`splash\`/\`favicon\` unset so Expo
+   uses its built-in defaults. Add your own branding assets whenever you're ready and
+   point \`app.json\` at them then.
 
-4. **Install dependencies:**
+3. **Install dependencies:**
    \`\`\`bash
    cd backend && bun install
    cd ../frontend && bun install
    \`\`\`
 
-5. **Start MongoDB as a replica set** (required for realtime/sync):
+4. **Start MongoDB as a replica set** (required for realtime/sync):
    \`\`\`bash
    # Using Docker (single-node replica set):
    docker run -d --name mongo -p 27017:27017 mongo:7 --replSet rs0
    docker exec mongo mongosh --eval 'rs.initiate({_id:"rs0",members:[{_id:0,host:"127.0.0.1:27017"}]})'
    \`\`\`
 
-6. **Start the backend:**
+5. **Start the backend:**
    \`\`\`bash
    cd backend && bun run dev
    \`\`\`
 
-7. **In a new terminal, regenerate and start the frontend:**
+7. **In a new terminal, seed login-ready development users:**
+   \`\`\`bash
+   cd backend && bun run seed
+   # Re-run safely after seed definitions change, or use --reset to reset managed data.
+   \`\`\`
+
+8. **In a new terminal, regenerate and start the frontend:**
    \`\`\`bash
    cd frontend
    bun run sdk  # Generate SDK from backend
    bun run web  # Start web frontend
    \`\`\`
 
-8. **Open http://localhost:8082** in your browser
+9. **Open http://localhost:8082** and sign in as \`test@example.com\` / \`testpassword123\`
 
 ## MCP Integration
 
@@ -2624,7 +2836,7 @@ This provides AI assistance with:
 `;
     const fileContents = files
         .map((f) => {
-        const lang = f.path.endsWith(".json") ? "json" : "typescript";
+        const lang = getFenceLanguage(f.path);
         return `### \`${f.path}\`
 
 \`\`\`${lang}
@@ -2678,13 +2890,12 @@ export const handleBootstrapPromptRequest = (name, args) => {
 Use the \`terreno_bootstrap_app\` tool to generate all the necessary files for the application.
 
 After generating the files:
-1. Create all directories and files as specified
-2. Download assets from Expo's GitHub using the provided curl commands
-3. Install dependencies with \`bun install\`
-4. Start MongoDB
-5. Start the backend with \`bun run dev\`
-6. Generate the SDK with \`bun run sdk\` in the frontend
-7. Start the frontend with \`bun run web\`
+1. Create all directories and files as specified (no \`assets/\` directory is required)
+2. Install dependencies with \`bun install\`
+3. Start MongoDB
+4. Start the backend with \`bun run dev\`
+5. Generate the SDK with \`bun run sdk\` in the frontend
+6. Start the frontend with \`bun run web\`
 
 The application should include:
 - Better Auth login (email/password via \`@terreno/ui\` LoginScreen)