kitcn 0.13.2 → 0.13.4

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, B as runConfiguredCodegen, C as isEntryPoint, Ct as serializeEnvValue, D as parseInitCommandArgs, Dt as logger, E as parseBackendRunJson, F as resolveRunDeps, G as runMigrationFlow, H as runDevSchemaBackfillIfNeeded, I as runAfterScaffoldScript, J as withWorkingDirectory, K as trackProcess, L as runAggregateBackfillFlow, M as resolveDocTopic, N as resolveInitProjectDir, O as readPackageVersions, Ot as highlighter, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as resolveAuthEnvState, T as parseArgs, U as runInitCommandFlow, V as runConvexInitIfNeeded, W as runMigrationCreate, X as collectPluginScaffoldTemplates, Y as createSpinner, Z as filterScaffoldTemplatePathMap, _ as formatInfoOutput, _t as applyPlanningDependencyInstall, a as cleanup, at as getPluginCatalogEntry, b as getDevAggregateBackfillStatePath, bt as resolveSupportedDependencyWarnings, c as createCommandEnv, ct as buildPluginInstallPlan, d as extractBackfillCliOptions, dt as collectInstalledPluginKeys, et as resolveAddTemplateDefaults, f as extractConcaveRunTargetArgs, ft as getPluginLockfilePath, g as formatDocsOutput, gt as applyDependencyHintsInstall, h as extractResetCliOptions, ht as resolveSchemaInstalledPlugins, i as buildInitializationPlan, it as resolveTemplatesByIdOrThrow, j as resolveConfiguredBackend, k as resolveBackfillConfig, l as ensureConvexGitignoreEntry, lt as resolvePluginScaffoldRoots, m as extractMigrationDownOptions, mt as readPluginLockfile, n as applyPluginInstallPlanFiles, nt as resolvePresetScaffoldTemplates, o as createBackendAdapter, ot as getSupportedPluginKeys, p as extractMigrationCliOptions, pt as getSchemaFilePath, q as withLocalCodegenEnv, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplateSelectionSource, s as createBackendCommandEnv, st as isSupportedPluginKey, t as applyDependencyInstallPlan, tt as resolvePluginPreset, u as extractBackendRunTargetArgs, ut as assertSchemaFileExists, v as getAggregateBackfillDeploymentKey, vt as applyPluginDependencyInstall, w as isInitialized, wt as stripConvexCommandNoise, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-B4DHUUfg.mjs";
+import { $ as promptForScaffoldTemplateSelection, A as resolveCodegenTrimSegments, B as runConfiguredCodegen, C as isEntryPoint, Ct as serializeEnvValue, D as parseInitCommandArgs, Dt as logger, E as parseBackendRunJson, F as resolveRunDeps, G as runMigrationFlow, H as runDevSchemaBackfillIfNeeded, I as runAfterScaffoldScript, J as withWorkingDirectory, K as trackProcess, L as runAggregateBackfillFlow, M as resolveDocTopic, N as resolveInitProjectDir, O as readPackageVersions, Ot as highlighter, P as resolveMigrationConfig, Q as promptForPluginSelection, R as runAggregatePruneFlow, S as isConvexDevPreRunConflictFlag, St as resolveAuthEnvState, T as parseArgs, U as runInitCommandFlow, V as runConvexInitIfNeeded, W as runMigrationCreate, X as collectPluginScaffoldTemplates, Y as createSpinner, Z as filterScaffoldTemplatePathMap, _ as formatInfoOutput, _t as applyPlanningDependencyInstall, a as cleanup, at as getPluginCatalogEntry, b as getDevAggregateBackfillStatePath, bt as resolveSupportedDependencyWarnings, c as createCommandEnv, ct as buildPluginInstallPlan, d as extractBackfillCliOptions, dt as collectInstalledPluginKeys, et as resolveAddTemplateDefaults, f as extractConcaveRunTargetArgs, ft as getPluginLockfilePath, g as formatDocsOutput, gt as applyDependencyHintsInstall, h as extractResetCliOptions, ht as resolveSchemaInstalledPlugins, i as buildInitializationPlan, it as resolveTemplatesByIdOrThrow, j as resolveConfiguredBackend, k as resolveBackfillConfig, l as ensureConvexGitignoreEntry, lt as resolvePluginScaffoldRoots, m as extractMigrationDownOptions, mt as readPluginLockfile, n as applyPluginInstallPlanFiles, nt as resolvePresetScaffoldTemplates, o as createBackendAdapter, ot as getSupportedPluginKeys, p as extractMigrationCliOptions, pt as getSchemaFilePath, q as withLocalCodegenEnv, r as assertNoRemovedDevPreRunFlag, rt as resolveTemplateSelectionSource, s as createBackendCommandEnv, st as isSupportedPluginKey, t as applyDependencyInstallPlan, tt as resolvePluginPreset, u as extractBackendRunTargetArgs, ut as assertSchemaFileExists, v as getAggregateBackfillDeploymentKey, vt as applyPluginDependencyInstall, w as isInitialized, wt as stripConvexCommandNoise, x as hasRemoteConvexDeploymentEnv, xt as resolveProjectScaffoldContext, y as getConvexDeploymentCommandEnv, yt as inspectPluginDependencyInstall, z as runBackendFunction } from "./backend-core-D2a2poAE.mjs";
 import fs, { existsSync, readFileSync } from "node:fs";
 import path, { delimiter, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -638,7 +638,7 @@ function resolveConcaveLocalSiteUrl(cwd = process.cwd()) {
 	const envLocalPath = join(cwd, ".env.local");
 	if (!fs.existsSync(envLocalPath)) return "http://localhost:3000";
 	const parsed = parseEnv(fs.readFileSync(envLocalPath, "utf8"));
-	return parsed.NEXT_PUBLIC_SITE_URL ?? parsed.VITE_SITE_URL ?? "http://localhost:3000";
+	return parsed.NEXT_PUBLIC_SITE_URL ?? parsed.EXPO_PUBLIC_SITE_URL ?? parsed.VITE_SITE_URL ?? "http://localhost:3000";
 }
 function resolveImplicitConvexRemoteDeploymentEnv(cwd = process.cwd()) {
 	const envLocalPath = join(cwd, ".env.local");
@@ -1571,6 +1571,7 @@ const handleAggregateCommand = async (argv, deps = {}) => {
 		realConvexPath,
 		realConcavePath
 	});
+	const commandEnv = backend === "convex" ? getConvexDeploymentCommandEnv() : void 0;
 	const { remainingArgs: aggregateCommandArgs, overrides: aggregateBackfillOverrides } = extractBackfillCliOptions(parsed.restArgs.slice(1));
 	const aggregateArgs = [...config.deploy.args, ...aggregateCommandArgs];
 	const backfillConfig = {
@@ -1581,7 +1582,8 @@ const handleAggregateCommand = async (argv, deps = {}) => {
 	if (subcommand === "prune") return runAggregatePruneFlow({
 		execaFn,
 		backendAdapter,
-		targetArgs
+		targetArgs,
+		env: commandEnv
 	});
 	return runAggregateBackfillFlow({
 		execaFn,
@@ -1589,6 +1591,7 @@ const handleAggregateCommand = async (argv, deps = {}) => {
 		backfillConfig,
 		mode: subcommand === "rebuild" ? "rebuild" : "resume",
 		targetArgs,
+		env: commandEnv,
 		context: "aggregate"
 	});
 };
@@ -2169,7 +2172,7 @@ const INIT_LOCAL_BOOTSTRAP_PROMPT = "Run one-shot local Convex bootstrap after i
 const INIT_HELP_TEXT = `Usage: kitcn init [options]
 
 Options:
-  --template, -t    App template ("next", "start", or "vite") for fresh app scaffolding
+  --template, -t    App template ("next", "expo", "start", or "vite") for fresh app scaffolding
   --cwd             Target directory (or parent when used with --name)
   --name            Project name when scaffolding a fresh app
   --prod            Forward to \`convex init\`
@@ -2342,6 +2345,7 @@ const handleMigrateCommand = async (argv, deps = {}) => {
 		realConvexPath,
 		realConcavePath
 	});
+	const commandEnv = backend === "convex" ? getConvexDeploymentCommandEnv() : void 0;
 	if (migrateArgs.subcommand === "create") {
 		const rawName = migrateArgs.restArgs.join(" ").trim();
 		if (!rawName) throw new Error("Missing migration name. Usage: `kitcn migrate create <name>`.");
@@ -2364,6 +2368,7 @@ const handleMigrateCommand = async (argv, deps = {}) => {
 		backendAdapter,
 		migrationConfig,
 		targetArgs,
+		env: commandEnv,
 		context: "migration",
 		direction: "up"
 	});
@@ -2374,13 +2379,14 @@ const handleMigrateCommand = async (argv, deps = {}) => {
 			backendAdapter,
 			migrationConfig,
 			targetArgs: extractBackendRunTargetArgs(backend, remainingArgs),
+			env: commandEnv,
 			context: "migration",
 			direction: "down",
 			steps,
 			to
 		});
 	}
-	if (migrateArgs.subcommand === "status") return (await runBackendFunction(execaFn, backendAdapter, "generated/server:migrationStatus", {}, targetArgs)).exitCode;
+	if (migrateArgs.subcommand === "status") return (await runBackendFunction(execaFn, backendAdapter, "generated/server:migrationStatus", {}, targetArgs, { env: commandEnv })).exitCode;
 	let runId;
 	const cancelArgs = [];
 	for (let index = 0; index < commandArgs.length; index += 1) {
@@ -2401,7 +2407,7 @@ const handleMigrateCommand = async (argv, deps = {}) => {
 		cancelArgs.push(arg);
 	}
 	const cancelTargetArgs = extractBackendRunTargetArgs(backend, cancelArgs);
-	return (await runBackendFunction(execaFn, backendAdapter, "generated/server:migrationCancel", runId ? { runId } : {}, cancelTargetArgs)).exitCode;
+	return (await runBackendFunction(execaFn, backendAdapter, "generated/server:migrationCancel", runId ? { runId } : {}, cancelTargetArgs, { env: commandEnv })).exitCode;
 };
 
 //#endregion
@@ -2629,7 +2635,7 @@ const __filename = fileURLToPath(import.meta.url);
 const HELP_FLAGS = new Set(["--help", "-h"]);
 const VERSION_FLAGS = new Set(["--version", "-v"]);
 const packageJson = readOwnPackageJson(import.meta.url);
-const REMOVED_CREATE_MESSAGE = "Removed `kitcn create`. Use `kitcn init -t <next|start|vite>` for fresh app scaffolding.";
+const REMOVED_CREATE_MESSAGE = "Removed `kitcn create`. Use `kitcn init -t <next|expo|start|vite>` for fresh app scaffolding.";
 const LOCAL_NODE_REEXEC_ENV = "KITCN_NODE_REEXEC";
 const LOCAL_NODE_REEXEC_COMMANDS = new Set([
 	"add",

package/dist/watcher.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Dt as logger, Et as getConvexConfig, F as resolveRunDeps, Tt as generateMeta, j as resolveConfiguredBackend, q as withLocalCodegenEnv } from "./backend-core-B4DHUUfg.mjs";
+import { Dt as logger, Et as getConvexConfig, F as resolveRunDeps, Tt as generateMeta, j as resolveConfiguredBackend, q as withLocalCodegenEnv } from "./backend-core-D2a2poAE.mjs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitcn",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "kitcn - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",

package/skills/convex/references/setup/expo.md

@@ -0,0 +1,73 @@
+# Expo Setup
+
+Use Expo when you want the official `create-expo-app` shell with the kitcn
+Convex baseline layered on top.
+
+## Fresh scaffold
+
+```bash
+npx kitcn@latest init -t expo --yes
+```
+
+This path owns:
+
+- `.env.local`
+- `expo-env.d.ts`
+- `src/components/providers.tsx`
+- `src/lib/convex/*`
+- `src/app/_layout.tsx`
+- `src/app/index.tsx`
+- `convex/functions/schema.ts`
+- `convex/functions/messages.ts`
+- `convex/lib/crpc.ts`
+- `convex/lib/get-env.ts`
+- `convex/shared/api.ts`
+
+V1 scope stays narrow:
+
+- fresh scaffold only
+- no existing Expo adoption
+- no styling-framework layer beyond the official Expo baseline
+
+## Add auth
+
+Expo uses the default auth scaffold:
+
+```bash
+npx kitcn@latest init -t expo --yes
+npx kitcn add auth --yes
+npx kitcn add auth --schema --yes
+```
+
+This writes:
+
+- `src/lib/convex/auth-client.ts`
+- `src/lib/convex/convex-provider.tsx`
+- `src/app/auth.tsx`
+- `convex/functions/auth.config.ts`
+- `convex/functions/auth.ts`
+- auth-owned blocks in `convex/functions/schema.ts`
+
+Expo auth keeps managed schema refresh. It is not a separate preset.
+
+## Env contract
+
+```bash
+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
+```
+
+Use `process.env.EXPO_PUBLIC_*` directly in client code.
+
+## Run it
+
+```bash
+# terminal 1
+npx kitcn dev
+
+# terminal 2
+bun run start
+```
+
+The starter app opens to one native messages screen backed by Convex.

package/skills/convex/references/setup/index.md

@@ -107,6 +107,12 @@ npx kitcn@latest --backend concave init --yes
 # New Next.js app with deterministic shadcn bootstrap + first local Convex bootstrap
 npx kitcn@latest init -t next --yes
 
+# New Expo app with the official create-expo-app shell + first local Convex bootstrap
+npx kitcn@latest init -t expo --yes
+
+# New TanStack Start app with the official shadcn Start shell + first local Convex bootstrap
+npx kitcn@latest init -t start --yes
+
 # New Vite app with the React baseline + first local Convex bootstrap
 npx kitcn@latest init -t vite --yes
 
@@ -175,6 +181,8 @@ Universal scaffold rule:
 Public template keys stay concrete:
 
 - `next`
+- `expo`
+- `start`
 - `vite`
 
 Internal scaffold modes stay broad:
@@ -184,6 +192,7 @@ Internal scaffold modes stay broad:
 
 Framework mapping:
 
+- `expo` -> `expo`
 - `next-app` -> `next-app`
 - `next-pages`, `vite`, `react-router`, `tanstack-start`, `manual` -> `react`
 

package/skills/convex/references/setup/server.md

@@ -1,6 +1,6 @@
 ## 5. Core Backend
 
-For production bootstrap, start in the CLI Registry: use `npx kitcn@latest init -t <next|vite> --yes` for the shortest fresh local path, `npx kitcn@latest init --yes` to adopt the current app and finish the first local Convex bootstrap in one command, and `bunx kitcn add <plugin>` for feature layers. This file is the manual backend wiring reference.
+For production bootstrap, start in the CLI Registry: use `npx kitcn@latest init -t <next|expo|start|vite> --yes` for the shortest fresh local path, `npx kitcn@latest init --yes` to adopt the current app and finish the first local Convex bootstrap in one command, and `bunx kitcn add <plugin>` for feature layers. This file is the manual backend wiring reference.
 
 ### 5.1 Define schema and relations