create-100x-mobile 0.4.10 → 0.5.0

package/dist/cli.js

@@ -17,13 +17,14 @@ Options:
   --no-install            Skip dependency installation
   --skip-git              Skip git init/commit
   --backend <provider>    Backend: "convex" or "instantdb"
+  --instant-auth <mode>   InstantDB auth: "clerk", "magic-code", or "magic-code-cloudflare"
   --sdk <value>           Use "latest", "previous", or a specific version (e.g. 54.0.33)
   --clerk-pk <key>        Pre-fill Clerk publishable key
   --clerk-domain <domain> Pre-fill Clerk issuer domain
   --instant-app-id <id>   Pre-fill InstantDB app id
   --instant-clerk-client-name <name> Client name configured in Instant Auth tab
 
-Scaffolds a mobile app with Expo + Convex/Clerk or Expo + InstantDB.
+Scaffolds a mobile app with Expo + Convex/Clerk, Expo + InstantDB, or InstantDB magic code + Cloudflare.
 `);
 }
 async function main() {

package/dist/commands/new/args.js

@@ -16,6 +16,21 @@ function getInlineOrNextValue(arg, args, i) {
     }
     return { value: nextValue.trim(), nextIndex: i + 1 };
 }
+function parseInstantAuthMode(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "clerk") {
+        return "clerk";
+    }
+    if (normalized === "magic-code" || normalized === "magic-link") {
+        return "magic-code";
+    }
+    if (normalized === "cloudflare" ||
+        normalized === "magic-code-cloudflare" ||
+        normalized === "magic-link-cloudflare") {
+        return "magic-code-cloudflare";
+    }
+    throw new Error(`Invalid --instant-auth value "${value}". Use "clerk", "magic-code", "magic-link", or "magic-code-cloudflare".`);
+}
 function parseNewCommandArgs(args) {
     const options = {
         interactive: true,
@@ -23,6 +38,7 @@ function parseNewCommandArgs(args) {
         initializeGit: true,
         sdk: null,
         backend: null,
+        instantAuthMode: null,
         clerkPublishableKey: null,
         clerkDomain: null,
         instantAppId: null,
@@ -68,6 +84,12 @@ function parseNewCommandArgs(args) {
             i = nextIndex;
             continue;
         }
+        if (arg === "--instant-auth" || arg.startsWith("--instant-auth=")) {
+            const { value, nextIndex } = getInlineOrNextValue(arg, args, i);
+            options.instantAuthMode = parseInstantAuthMode(value);
+            i = nextIndex;
+            continue;
+        }
         if (arg === "--clerk-pk" || arg.startsWith("--clerk-pk=")) {
             const { value, nextIndex } = getInlineOrNextValue(arg, args, i);
             options.clerkPublishableKey = value;
@@ -98,5 +120,8 @@ function parseNewCommandArgs(args) {
     if (!projectName && !options.interactive) {
         projectName = "my-app";
     }
+    if (options.backend === "instantdb" && !options.instantAuthMode) {
+        options.instantAuthMode = "clerk";
+    }
     return { projectName, options };
 }

package/dist/commands/new/scaffold.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCloudflareInstantAuthMode = isCloudflareInstantAuthMode;
+exports.isMagicCodeInstantAuthMode = isMagicCodeInstantAuthMode;
 exports.createProjectDirectories = createProjectDirectories;
 exports.writeScaffoldFiles = writeScaffoldFiles;
 exports.writeDefaultAssetFiles = writeDefaultAssetFiles;
@@ -7,16 +9,24 @@ const node_path_1 = require("node:path");
 const fs_1 = require("../../lib/fs");
 // 1x1 transparent PNG placeholder.
 const TRANSPARENT_PNG_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO7+P5kAAAAASUVORK5CYII=";
-async function createProjectDirectories(projectDir, backend) {
-    const commonDirs = [
-        "app/(tabs)",
-        "hooks",
-        "assets/images",
-    ];
+function isCloudflareInstantAuthMode(instantAuthMode) {
+    return instantAuthMode === "magic-code-cloudflare";
+}
+function isMagicCodeInstantAuthMode(instantAuthMode) {
+    return (instantAuthMode === "magic-code" ||
+        instantAuthMode === "magic-code-cloudflare");
+}
+async function createProjectDirectories(projectDir, backend, instantAuthMode = "clerk") {
+    const commonDirs = ["app/(tabs)", "hooks", "assets/images"];
     const backendDirs = backend === "convex"
         ? ["app/(auth)", "app/providers", "components", "convex"]
-        : ["app/(auth)", "app/providers", "lib"];
-    const dirs = [...commonDirs, ...backendDirs];
+        : isMagicCodeInstantAuthMode(instantAuthMode)
+            ? ["app/(auth)", "lib"]
+            : ["app/(auth)", "app/providers", "lib"];
+    const cloudflareDirs = isCloudflareInstantAuthMode(instantAuthMode)
+        ? ["worker/src", "worker/migrations"]
+        : [];
+    const dirs = [...commonDirs, ...backendDirs, ...cloudflareDirs];
     for (const dir of dirs) {
         await (0, fs_1.ensureDir)((0, node_path_1.join)(projectDir, dir));
     }

package/dist/commands/new/steps.js

@@ -6,8 +6,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeClerkDomain = normalizeClerkDomain;
 exports.toErrorMessage = toErrorMessage;
 exports.resolveBackendChoice = resolveBackendChoice;
+exports.resolveInstantAuthMode = resolveInstantAuthMode;
 exports.resolveExpoVersion = resolveExpoVersion;
 exports.installDependencies = installDependencies;
+exports.buildExpoInstallPackages = buildExpoInstallPackages;
 exports.resolveExpoDependencies = resolveExpoDependencies;
 exports.promptClerkSetup = promptClerkSetup;
 exports.promptInstantSetup = promptInstantSetup;
@@ -25,6 +27,7 @@ const clerk_1 = require("../../lib/clerk");
 const dotenv_1 = require("../../lib/dotenv");
 const fs_1 = require("../../lib/fs");
 const run_1 = require("../../lib/run");
+const scaffold_1 = require("./scaffold");
 function normalizeClerkDomain(rawDomain) {
     const trimmed = rawDomain.trim();
     if (!trimmed)
@@ -89,6 +92,39 @@ async function resolveBackendChoice(options) {
     }
     return choice;
 }
+async function resolveInstantAuthMode(options) {
+    if (options.instantAuthMode) {
+        return options.instantAuthMode;
+    }
+    if (!options.interactive) {
+        return "clerk";
+    }
+    const choice = await (0, prompts_1.select)({
+        message: "Which InstantDB auth flow do you want?",
+        options: [
+            {
+                value: "clerk",
+                label: "Clerk",
+                hint: "Current InstantDB + Clerk flow",
+            },
+            {
+                value: "magic-code",
+                label: "Magic code",
+                hint: "Email code auth with InstantDB",
+            },
+            {
+                value: "magic-code-cloudflare",
+                label: "Magic code + Cloudflare",
+                hint: "InstantDB realtime, R2 storage, D1 metadata",
+            },
+        ],
+        initialValue: "clerk",
+    });
+    if ((0, prompts_1.isCancel)(choice)) {
+        return "clerk";
+    }
+    return choice;
+}
 async function resolveExpoVersion(options) {
     if (options.sdk) {
         const normalized = normalizeSdkArg(options.sdk);
@@ -175,7 +211,7 @@ async function installDependencies(projectDir) {
         }
     }
 }
-async function resolveExpoDependencies(projectDir, backend) {
+function buildExpoInstallPackages(backend, instantAuthMode = "clerk") {
     const commonExpoPackages = [
         "react",
         "react-dom",
@@ -200,14 +236,22 @@ async function resolveExpoDependencies(projectDir, backend) {
     ];
     const backendExpoPackages = backend === "convex"
         ? ["expo-auth-session", "expo-secure-store", "expo-web-browser"]
-        : [
-            "expo-auth-session",
-            "expo-secure-store",
-            "expo-web-browser",
-            "@react-native-async-storage/async-storage",
-            "@react-native-community/netinfo",
-        ];
-    const expoPackages = [...commonExpoPackages, ...backendExpoPackages];
+        : (0, scaffold_1.isMagicCodeInstantAuthMode)(instantAuthMode)
+            ? [
+                "@react-native-async-storage/async-storage",
+                "@react-native-community/netinfo",
+            ]
+            : [
+                "expo-auth-session",
+                "expo-secure-store",
+                "expo-web-browser",
+                "@react-native-async-storage/async-storage",
+                "@react-native-community/netinfo",
+            ];
+    return [...commonExpoPackages, ...backendExpoPackages];
+}
+async function resolveExpoDependencies(projectDir, backend, instantAuthMode = "clerk") {
+    const expoPackages = buildExpoInstallPackages(backend, instantAuthMode);
     try {
         await (0, run_1.run)("npx", ["expo", "install", ...expoPackages], { cwd: projectDir });
         return true;
@@ -220,7 +264,9 @@ async function resolveExpoDependencies(projectDir, backend) {
 }
 async function promptClerkSetup(options) {
     let publishableKey = options.clerkPublishableKey?.trim() ?? "";
-    let domain = options.clerkDomain ? normalizeClerkDomain(options.clerkDomain) : "";
+    let domain = options.clerkDomain
+        ? normalizeClerkDomain(options.clerkDomain)
+        : "";
     let jwtCreated = false;
     if (!publishableKey && options.interactive) {
         prompts_1.log.info("");
@@ -279,8 +325,32 @@ async function promptClerkSetup(options) {
     }
     return { publishableKey, domain, jwtCreated };
 }
-async function promptInstantSetup(options) {
+async function promptInstantSetup(options, authMode) {
     let appId = options.instantAppId?.trim() ?? "";
+    if ((0, scaffold_1.isMagicCodeInstantAuthMode)(authMode)) {
+        if (options.interactive) {
+            prompts_1.log.info("");
+            prompts_1.log.info(picocolors_1.default.bold((0, scaffold_1.isCloudflareInstantAuthMode)(authMode)
+                ? "InstantDB Magic Code + Cloudflare Setup"
+                : "InstantDB Magic Code Setup"));
+            prompts_1.log.info(picocolors_1.default.dim("Create an app id with: npx instant-cli init-without-files --title my-app"));
+            if ((0, scaffold_1.isCloudflareInstantAuthMode)(authMode)) {
+                prompts_1.log.info(picocolors_1.default.dim("Cloudflare Worker, R2, and D1 files will be generated. Run `bun run cloudflare:deploy` after installing dependencies."));
+            }
+            if (!appId) {
+                prompts_1.log.info(picocolors_1.default.dim("Press Enter to skip and configure later."));
+                const appIdInput = await (0, prompts_1.text)({
+                    message: "InstantDB App ID",
+                    placeholder: "your-instant-app-id",
+                    defaultValue: "",
+                });
+                if (!(0, prompts_1.isCancel)(appIdInput) && appIdInput) {
+                    appId = appIdInput.trim();
+                }
+            }
+        }
+        return { authMode, appId };
+    }
     let clerkPublishableKey = options.clerkPublishableKey?.trim() ?? "";
     let clerkClientName = options.instantClerkClientName?.trim() || "clerk";
     if (options.interactive) {
@@ -320,7 +390,7 @@ async function promptInstantSetup(options) {
             clerkClientName = clientNameInput.trim();
         }
     }
-    return { appId, clerkPublishableKey, clerkClientName };
+    return { authMode: "clerk", appId, clerkPublishableKey, clerkClientName };
 }
 async function writeAuthEnvironment(projectDir, clerk) {
     const envLocalPath = (0, node_path_1.join)(projectDir, ".env.local");
@@ -348,7 +418,15 @@ async function writeAuthEnvironment(projectDir, clerk) {
     }
 }
 async function writeInstantEnvironment(projectDir, instant) {
-    if (!instant.appId && !instant.clerkPublishableKey && !instant.clerkClientName) {
+    if ((0, scaffold_1.isMagicCodeInstantAuthMode)(instant.authMode)) {
+        if (!instant.appId) {
+            return;
+        }
+    }
+    else if (instant.authMode === "clerk" &&
+        !instant.appId &&
+        !instant.clerkPublishableKey &&
+        !instant.clerkClientName) {
         return;
     }
     const envLocalPath = (0, node_path_1.join)(projectDir, ".env.local");
@@ -364,10 +442,22 @@ async function writeInstantEnvironment(projectDir, instant) {
     if (instant.appId) {
         envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_INSTANT_APP_ID", instant.appId);
     }
-    if (instant.clerkPublishableKey) {
-        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY", instant.clerkPublishableKey);
+    if ((0, scaffold_1.isCloudflareInstantAuthMode)(instant.authMode)) {
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "INSTANT_APP_ID", instant.appId);
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "INSTANT_ADMIN_TOKEN", "");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "ALLOWED_ORIGINS", "http://localhost:3000,http://localhost:8080,http://localhost:8081,http://localhost:19006");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "MAX_UPLOAD_BYTES", "26214400");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "USER_STORAGE_LIMIT_BYTES", "524288000");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "DAILY_UPLOAD_LIMIT", "100");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "ALLOWED_CONTENT_TYPES", "image/jpeg,image/png,image/webp,application/pdf,text/plain");
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_STORAGE_WORKER_URL", "");
+    }
+    if (instant.authMode === "clerk") {
+        if (instant.clerkPublishableKey) {
+            envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY", instant.clerkPublishableKey);
+        }
+        envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME", instant.clerkClientName || "clerk");
     }
-    envContents = (0, dotenv_1.upsertDotenvVar)(envContents, "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME", instant.clerkClientName || "clerk");
     await (0, fs_1.writeTextFile)(envLocalPath, envContents);
 }
 async function initializeConvex(projectDir) {
@@ -448,7 +538,7 @@ async function initializeGit(projectDir) {
         return false;
     }
 }
-async function runHealthChecks(projectDir, backend, clerkPublishableKey) {
+async function runHealthChecks(projectDir, backend, instantAuthMode, clerkPublishableKey) {
     const envLocalPath = (0, node_path_1.join)(projectDir, ".env.local");
     const checks = [];
     const envExists = await (0, fs_1.pathExists)(envLocalPath);
@@ -456,14 +546,30 @@ async function runHealthChecks(projectDir, backend, clerkPublishableKey) {
     if (!envExists) {
         if (backend === "instantdb") {
             checks.push({ label: "EXPO_PUBLIC_INSTANT_APP_ID is set", ok: false });
-            checks.push({
-                label: "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY is set",
-                ok: false,
-            });
-            checks.push({
-                label: "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME is set",
-                ok: false,
-            });
+            if (instantAuthMode === "clerk") {
+                checks.push({
+                    label: "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY is set",
+                    ok: false,
+                });
+                checks.push({
+                    label: "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME is set",
+                    ok: false,
+                });
+            }
+            if ((0, scaffold_1.isCloudflareInstantAuthMode)(instantAuthMode)) {
+                checks.push({
+                    label: "INSTANT_APP_ID is set for Cloudflare deploy",
+                    ok: false,
+                });
+                checks.push({
+                    label: "INSTANT_ADMIN_TOKEN is set for Cloudflare deploy",
+                    ok: false,
+                });
+                checks.push({
+                    label: "EXPO_PUBLIC_STORAGE_WORKER_URL is set",
+                    ok: false,
+                });
+            }
         }
         else {
             checks.push({ label: "EXPO_PUBLIC_CONVEX_URL is set", ok: false });
@@ -488,14 +594,35 @@ async function runHealthChecks(projectDir, backend, clerkPublishableKey) {
             label: "EXPO_PUBLIC_INSTANT_APP_ID is set",
             ok: envContent.includes("EXPO_PUBLIC_INSTANT_APP_ID"),
         });
-        checks.push({
-            label: "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY is set",
-            ok: envContent.includes("EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY"),
-        });
-        checks.push({
-            label: "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME is set",
-            ok: envContent.includes("EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME"),
-        });
+        if (instantAuthMode === "clerk") {
+            checks.push({
+                label: "EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY is set",
+                ok: envContent.includes("EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY"),
+            });
+            checks.push({
+                label: "EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME is set",
+                ok: envContent.includes("EXPO_PUBLIC_INSTANT_CLERK_CLIENT_NAME"),
+            });
+        }
+        if ((0, scaffold_1.isCloudflareInstantAuthMode)(instantAuthMode)) {
+            const env = (0, dotenv_1.parseDotenv)(envContent);
+            checks.push({
+                label: "INSTANT_APP_ID is set for Cloudflare deploy",
+                ok: Boolean(env["INSTANT_APP_ID"]),
+            });
+            checks.push({
+                label: "INSTANT_ADMIN_TOKEN is set for Cloudflare deploy",
+                ok: Boolean(env["INSTANT_ADMIN_TOKEN"]),
+            });
+            checks.push({
+                label: "ALLOWED_ORIGINS is set for Cloudflare deploy",
+                ok: Boolean(env["ALLOWED_ORIGINS"]),
+            });
+            checks.push({
+                label: "EXPO_PUBLIC_STORAGE_WORKER_URL is set",
+                ok: Boolean(env["EXPO_PUBLIC_STORAGE_WORKER_URL"]),
+            });
+        }
     }
     else {
         checks.push({