kitcn 0.13.2 → 0.13.3

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-BV61sNRx.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");
@@ -2169,7 +2169,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\`
@@ -2629,7 +2629,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-BV61sNRx.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.3",
   "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