@mediamonks/canopy-cli 0.3.0 → 0.3.1

package/dist/docs/getting-started.md

@@ -60,9 +60,14 @@ This prompts for a name and a starter template, scaffolds a runnable project
 directory, and registers the project on the platform. To skip the prompts:
 
 ```bash
-canopy create "My App" --scaffold --template static
+canopy create "My App" --scaffold --template spa
 ```
 
+Templates: **`static`** (no-build html/css/js; SDK served untyped from the
+platform) is the default and fine for a trivial page or two. Reach for
+**`spa`** (Vite + React + TypeScript; typed SDK from npm) once you lean on the
+SDK or expect the app to grow — most projects want this.
+
 ## 4. Run it locally
 
 ```bash

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "./package-DyEUYkEq.mjs";
+import { t as version } from "./package-B34Xg7L3.mjs";
 import { i as runRefresh, r as notifyOfUpdate } from "./version-check-CoWgQs2h.mjs";
 import { defineCommand, runMain } from "citty";
 //#region src/index.ts
@@ -44,9 +44,9 @@ const main = defineCommand({
 		login: () => import("./login-Dif9Y32q.mjs").then((m) => m.loginCommand),
 		whoami: () => import("./login-Dif9Y32q.mjs").then((m) => m.whoamiCommand),
 		logout: () => import("./login-Dif9Y32q.mjs").then((m) => m.logoutCommand),
-		create: () => import("./projects-DJT_mJDR.mjs").then((m) => m.createCommand),
-		projects: () => import("./projects-DJT_mJDR.mjs").then((m) => m.projectsCommand),
-		delete: () => import("./projects-DJT_mJDR.mjs").then((m) => m.deleteCommand),
+		create: () => import("./projects-DOYKtMZC.mjs").then((m) => m.createCommand),
+		projects: () => import("./projects-DOYKtMZC.mjs").then((m) => m.projectsCommand),
+		delete: () => import("./projects-DOYKtMZC.mjs").then((m) => m.deleteCommand),
 		dev: () => import("./dev-D_GlUULk.mjs").then((m) => m.devCommand),
 		deploy: () => import("./deploy-N88l4Kt3.mjs").then((m) => m.deployCommand),
 		rollback: () => import("./deploy-N88l4Kt3.mjs").then((m) => m.rollbackCommand),
@@ -54,8 +54,8 @@ const main = defineCommand({
 		db: () => import("./db-CtUG4vfG.mjs").then((m) => m.dbCommand),
 		open: () => import("./open-xLiGUz_W.mjs").then((m) => m.openCommand),
 		docs: () => import("./docs-C3aOAx_A.mjs").then((m) => m.docsCommand),
-		skill: () => import("./skill-nN0e59rO.mjs").then((m) => m.skillCommand),
-		upgrade: () => import("./upgrade-C5IoUEZg.mjs").then((m) => m.upgradeCommand),
+		skill: () => import("./skill-BlRch5eA.mjs").then((m) => m.skillCommand),
+		upgrade: () => import("./upgrade-DblPIwpX.mjs").then((m) => m.upgradeCommand),
 		logs: planned("logs", "Tail worker logs", "2")
 	}
 });

package/dist/{package-DyEUYkEq.mjs → package-B34Xg7L3.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.3.0";
+var version = "0.3.1";
 //#endregion
 export { version as t };

package/dist/{projects-DJT_mJDR.mjs → projects-DOYKtMZC.mjs}

@@ -21,12 +21,12 @@ const TEMPLATES = [
 	{
 		id: "static",
 		label: "Static site",
-		hint: "plain html/css/js, no build step (default)"
+		hint: "plain html/css/js, no build; untyped SDK from the platform — simplest apps only"
 	},
 	{
 		id: "spa",
 		label: "React SPA",
-		hint: "Vite + React + TypeScript, SDK from npm",
+		hint: "Vite + React + TypeScript, typed SDK from npm — best for real SDK use or growth",
 		needsInstall: true
 	},
 	{

package/dist/skill/canopy/SKILL.md

@@ -70,6 +70,29 @@ truth and never go stale.
 - Manage data: `canopy db pull | snapshot | snapshots | restore`
 - CI credentials: `canopy token create | list | revoke`
 
+## Choosing a starter template (`canopy create`)
+
+`canopy create` offers three scaffolds. **`static` is the default, but reach
+for it only when the app is genuinely trivial** — a page or two with light SDK
+use. Its SDK is served untyped from the platform (`/_api/v1/sdk.js`): no
+autocomplete, no type-checking, mistakes only show up in the browser.
+
+Prefer **`spa`** the moment either is true — which covers most real projects:
+
+- **You lean on the SDK** (`db` queries, `blob`, `ai` — anything past a stray
+  `auth.user()`). `spa` installs the SDK from npm (`@mediamonks/canopy`), fully
+  typed, so the compiler catches mistakes as you write them.
+- **The app will grow.** `spa` is Vite + React + TypeScript, giving components,
+  routing, and state a real home; `static` has no build step to organise into.
+
+Use **`worker`** (`--template worker`; hidden from the picker) only when you
+need server-side backend code — e.g. calling an external API with a secret the
+browser can't hold. Per-project Workers are a Phase 2 preview (frontend deploys
+now; `worker/` is picked up once the platform supports it).
+
+Non-interactive: `canopy create "My App" --template spa`. **When unsure between
+`static` and `spa`, pick `spa`.**
+
 ## Safety rules
 
 - **Destructive commands** — `canopy db restore` and `canopy delete` wipe data.

package/dist/{skill-nN0e59rO.mjs → skill-BlRch5eA.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-DyEUYkEq.mjs";
+import { t as version } from "./package-B34Xg7L3.mjs";
 import { n as reportErrors } from "./ui-C8VuPzGp.mjs";
 import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";

package/dist/{upgrade-C5IoUEZg.mjs → upgrade-DblPIwpX.mjs}

@@ -115,7 +115,7 @@ const upgradeCommand = defineCommand({
 		console.log(`Upgrading via ${command}: ${command} ${cmd.join(" ")}`);
 		await run(command, cmd);
 		console.log(`\nDone. Run \`canopy --version\` to confirm.`);
-		const { skillInstalled } = await import("./skill-nN0e59rO.mjs");
+		const { skillInstalled } = await import("./skill-BlRch5eA.mjs");
 		if (skillInstalled(process.cwd())) {
 			console.log("Refreshing the Canopy agent skill in this repo…");
 			await run("canopy", ["skill", "install"]).catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediamonks/canopy-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Canopy CLI — create, develop and deploy Canopy projects.",
   "bin": {
     "canopy": "./dist/index.mjs"
@@ -19,8 +19,8 @@
     "hono": "^4.8.0",
     "miniflare": "^4.20260714.0",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.2.5",
-    "@mediamonks/canopy": "0.0.1",
-    "@mediamonks/canopy-data-plane": "0.0.1"
+    "@mediamonks/canopy-data-plane": "0.0.1",
+    "@mediamonks/canopy": "0.0.1"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",