@cimplify/cli 0.7.17 → 0.7.18

package/dist/{chunk-OJRMBHMT.mjs → chunk-MR3Q43SU.mjs}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { gitDetectRoot, gitCurrentBranch, gitCurrentSha, gitStatusPorcelain } from './chunk-K5464A3L.mjs';
 import { parseEnvFile } from './chunk-DBZ3UOQ2.mjs';
-import { package_default } from './chunk-NIDPHJ45.mjs';
+import { package_default } from './chunk-GAN7PG6N.mjs';
 import { parseArgs } from './chunk-C4M3DXKC.mjs';
 import { readAuthOrNull, readProjectLinkOrNull, readProjectState } from './chunk-UBAI443T.mjs';
 import { bold, dim, yellow, green, info, result, red } from './chunk-E2T2SBP5.mjs';

package/dist/dispatcher.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { TEMPLATES } from './chunk-XKO2EB5J.mjs';
-import { package_default } from './chunk-NIDPHJ45.mjs';
+import { TEMPLATES } from './chunk-HWHV62KB.mjs';
+import { package_default } from './chunk-GAN7PG6N.mjs';
 
 // src/dispatcher.ts
 var VERSION = package_default.version ?? "unknown";
@@ -15,7 +15,7 @@ Project:
   cimplify logout                            Forget saved credentials
   cimplify whoami                            Show the current account/business
   cimplify projects ls                       List projects in the current business
-  cimplify projects create <name>            Create a Next.js project
+  cimplify projects create <name>            Create a storefront project
   cimplify link <project-id>                 Link CWD to a Cimplify project (writes .cimplify/project.json)
   cimplify unlink                            Remove the local project link
   cimplify introspect                        Snapshot the current storefront: auth, link, brand, mock, env, git
@@ -127,7 +127,7 @@ var COMMANDS = {
   login: () => import('./login-3OD4ND2H.mjs'),
   logout: () => import('./logout-3RLBZ33M.mjs'),
   whoami: () => import('./whoami-DNZ7RUTH.mjs'),
-  projects: () => import('./projects-JSEC2YCX.mjs'),
+  projects: () => import('./projects-QSUWVTJZ.mjs'),
   link: () => import('./link-DZSILT5N.mjs'),
   unlink: () => import('./unlink-RFK74SFP.mjs'),
   deploy: () => import('./deploy-YVCYHNSS.mjs'),
@@ -138,16 +138,16 @@ var COMMANDS = {
   logs: () => import('./logs-YNN2PQ24.mjs'),
   status: () => import('./status-JSYXM5RT.mjs'),
   dev: () => import('./dev-ONW2S77K.mjs'),
-  introspect: () => import('./introspect-HWOZIVET.mjs'),
+  introspect: () => import('./introspect-ZS6I46OO.mjs'),
   inspect: () => import('./inspect-CGYX4DDF.mjs'),
-  doctor: () => import('./doctor-AMR3MFFS.mjs'),
-  explain: () => import('./explain-6LYQ2OL4.mjs'),
+  doctor: () => import('./doctor-IGQNPWUY.mjs'),
+  explain: () => import('./explain-IK2FYBB7.mjs'),
   assets: () => import('./assets-74SK63TR.mjs'),
   repo: () => import('./repo-KNQMSPVV.mjs'),
-  list: () => import('./list-WC7JWDCJ.mjs'),
-  add: () => import('./add-VSGQEUDS.mjs'),
-  update: () => import('./update-6LL5PQEQ.mjs'),
-  upgrade: () => import('./update-6LL5PQEQ.mjs'),
+  list: () => import('./list-P74FSKQR.mjs'),
+  add: () => import('./add-UXXUPBKR.mjs'),
+  update: () => import('./update-E6Q3KV3B.mjs'),
+  upgrade: () => import('./update-E6Q3KV3B.mjs'),
   "auth-step-up": () => import('./auth-step-up-BIUYQJP6.mjs')
 };
 var COMMAND_PREFIXES = {

package/dist/{doctor-AMR3MFFS.mjs → doctor-IGQNPWUY.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { gatherIntrospection } from './chunk-OJRMBHMT.mjs';
+import { gatherIntrospection } from './chunk-MR3Q43SU.mjs';
 import './chunk-K5464A3L.mjs';
 import './chunk-DBZ3UOQ2.mjs';
-import './chunk-NIDPHJ45.mjs';
+import './chunk-GAN7PG6N.mjs';
 import { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
 import { ApiClient } from './chunk-MAOO6ZZ5.mjs';
 import { readAuthOrNull } from './chunk-UBAI443T.mjs';

package/dist/{explain-6LYQ2OL4.mjs → explain-IK2FYBB7.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-NIDPHJ45.mjs';
+import { package_default } from './chunk-GAN7PG6N.mjs';
 import { parseArgs } from './chunk-C4M3DXKC.mjs';
 import { bold, dim, info, result, CliError, CLI_ERROR_CODE } from './chunk-E2T2SBP5.mjs';
 
@@ -171,7 +171,7 @@ var TOPICS = [
     "title": "Agent prompts",
     "description": "Copy-paste prompts for common Cimplify workflows",
     "source_url": "https://cimplify.dev/docs/agent-prompts",
-    "body": 'These prompts are deliberately terse. Each one names the canonical doc the agent should read first, the exact commands or [MCP tools](/docs/mcp) to call, and the exit condition. Replace `<angle-bracket>` placeholders before running.\n\nEvery prompt assumes the agent has either:\n\n- the [Cimplify CLI](/docs/cli) installed and `cimplify login` complete, **or**\n- an MCP connection to `https://api.cimplify.io/mcp` ([setup](/docs/mcp#connect))\n\n## Ship a new storefront end-to-end\n\n```text title="Scaffold \u2192 deploy \u2192 custom domain"\nSet up a Cimplify <retail> storefront called <my-store> and deploy it to <shop.example.com>.\n\nSource of truth: https://cimplify.dev/docs/tldr\n- Use the MCP tools at api.cimplify.io/mcp when available; otherwise shell `cimplify <cmd> --json`.\n- After every command, echo the JSON envelope.\n- Stop on the first non-zero exit code and name it from https://cimplify.dev/docs/cli#exit-codes.\n- Poll deployment status with cimplify_get_deployment_status (or `cimplify status --json`); never `sleep`.\n- Idempotent \u2014 re-running any step is safe.\n```\n\n## Rebrand an existing storefront\n\n```text title="Apply a new brand to a scaffolded template"\nRebrand the storefront in <./my-store> to match these tokens:\n  name: <Acme Coffee>\n  primary: <#0F172A>\n  accent: <#F59E0B>\n  fontDisplay: <"Playfair Display">\n  fontBody: <"Inter">\n\nRules (https://cimplify.dev/docs/templates/brand):\n- Single source of truth is `lib/brand.ts`. Update it first.\n- Mirror color tokens into `app/globals.css` `@theme` block. Do not hard-code colors elsewhere.\n- Do not edit ejected SDK components; they pick up tokens automatically.\n- Run `bun run check:brand` after edits; fix any schema errors it reports.\n- Verify by opening `http://localhost:3000` (start `bun dev` if not running).\n- Commit with message `brand: <name>`. Do not deploy.\n```\n\n## Add a homepage section\n\n```text title="New Server Component section, cache-tagged"\nAdd a `<Stories>` section to the homepage of the storefront in <./my-store>.\n\nPattern (mirrors the Server Component sections under `app/_sections/` in the scaffolded template):\n- Create `app/_sections/stories.tsx` as an async Server Component. Pass `cacheOptions: { revalidate: 3600, tags: [tags.collections()] }` to the SDK read (from `@cimplify/sdk/server`). Do NOT use `\'use cache\'` / `cacheTag` / `cacheLife` \u2014 Cimplify storefronts run on CF Workers where Cache Components is broken; use the ISR Previous Model.\n- Source data from `client.catalogue.getCollection({ slug: "stories" })`.\n- Render with the existing `<SectionHeader>` and `<ProductCard>` SDK components (do not eject).\n- Insert into `app/page.tsx` between the hero and the featured collection.\n- Run `bun run check` \u2014 must pass typecheck, lint, brand, cart-flow, contract.\n- Do not modify `lib/brand.ts` or any file under `components/ui/`.\n```\n\n## Migrate to a new SDK version\n\n```text title="SDK upgrade with breaking-change scan"\nUpgrade the storefront in <./my-store> from `@cimplify/sdk@<0.44.x>` to `@cimplify/sdk@<latest>`.\n\nProcess:\n- Read the release notes for the target range (`npm view @cimplify/sdk versions --json` to list, then `npm view @cimplify/sdk@<version>` per release).\n- Bump the pin in `package.json`, run `bun install`.\n- For each breaking change called out in the changelog, grep the project for the old symbol and apply the documented replacement.\n- Run `bun run check`. If `check:contract` fails, the SDK \u2194 mock contract drifted \u2014 stop and report.\n- Do not run `cimplify deploy`. End by printing a summary of every file you changed and every breaking change you applied.\n```\n\n## Add a custom checkout payment method\n\n```text title="Wire an additional payment option"\nAdd <mobile_money> as a checkout payment option in the storefront at <./my-store>.\n\nReference: https://cimplify.dev/docs/api-reference/checkout (flat ProcessArgs body \u2014 top-level fields, not nested).\n- The body shape is the contract \u2014 never wrap fields.\n- Eject the existing `<PaymentMethodPicker>` component with `cimplify add payment-method-picker`.\n- Add the option in the ejected picker, wiring the provider-specific body (e.g. `mobile_money_details: { phone_number, provider }`).\n- Validate the body against the typed `ProcessArgs` from `@cimplify/sdk`.\n- Run `bun run check:cart` \u2014 the add\u2192checkout flow must still pass.\n```\n\n## Provision a CI deploy key\n\n```text title="One-time setup for headless deploys"\nCreate a CI-scoped API key for the Cimplify project linked at <./my-store>, and write the GitHub Actions snippet that uses it.\n\nSteps:\n- Confirm `.cimplify/project.json` exists; if not, fail with NOT_LINKED (exit 4).\n- Print the dashboard URL the human needs to visit to create the key (https://app.cimplify.io/settings/developer).\n- Once the user provides `dk_live_\u2026`, store it as a repo secret named `CIMPLIFY_API_KEY` (instruct, do not perform).\n- Write `.github/workflows/deploy.yml` that runs on push to main: install CLI via the curl one-liner, `cimplify deploy --prod --api-key "$CIMPLIFY_API_KEY" --yes --json`.\n- Print the exit-code legend from https://cimplify.dev/docs/cli#exit-codes so the workflow can map failures.\n```\n\n## Diagnose a deploy that didn\'t go live\n\n```text title="Triage a failed or stuck deployment"\nThe latest deploy of the project at <./my-store> isn\'t live. Find out why.\n\nTriage path:\n- `cimplify status --json` \u2014 what\'s the latest deployment_id and status?\n- If status is `failed`, `cimplify logs --deployment <id> --json | tail -200`. Quote the first error line you see.\n- If status is `queued` or `building` for >5 minutes, the build is stuck \u2014 try `cimplify rollback <previous-deploy-id>`.\n- If status is `superseded` (exit 2), a newer push raced it; usually fine \u2014 confirm with `cimplify status` again.\n- If domains misroute, `cimplify domains ls --json` \u2014 confirm the verified+attached domain.\n- Report: deployment_id, status, the failing log line (if any), and the recommended next action. Do not auto-rollback without confirming.\n```\n\n## Add a hero image and reference it in the homepage\n\n```text title="Upload brand assets \u2192 use them in source"\nAdd the image at <./Downloads/hero.jpg> as the homepage hero for the storefront in <./my-store>.\n\nReference: https://cimplify.dev/docs/cli/assets\n- `cp <./Downloads/hero.jpg> public/hero/main.jpg`\n- `cimplify assets upload public/hero/ --folder hero --json` \u2014 captures the manifest entry for `hero/main.jpg`.\n- Edit `app/page.tsx`: replace the hero `<Image>` `src` with `assetUrl("hero/main.jpg")` from `@cimplify/sdk`.\n- Do NOT touch existing `<Image>` calls that point at Cloudinary or other external hosts \u2014 the loader passes them through unchanged.\n- Run `bun run check`. Open `http://localhost:3000`; verify the hero image renders.\n- Commit `cimplify-assets.json` along with the source change so the manifest is reviewable.\n```\n\n## Reset a sandbox storefront to a clean state\n\n```text title="Wipe and re-seed for repeatable demos"\nReset the local mock state for the storefront in <./my-store>.\n\n- Stop any running `bun dev` process.\n- `cimplify mock reset` (clears the in-process mock backing store).\n- `cimplify mock seed <retail>` (re-seeds with the chosen industry fixture).\n- `bun dev` to restart both servers.\n- Verify: `curl localhost:8787/v1/catalogue/products | jq \'.data | length\'` returns the expected seed count (~24 for retail).\n- Do not touch the linked cloud project; this is local-only.\n```\n\n## How these are built\n\nEvery prompt above is structured the same way so you can adapt them:\n\n1. **Goal** \u2014 one sentence, with `<angle-bracket>` placeholders for the moving parts.\n2. **Source of truth** \u2014 the canonical doc URL the agent reads first.\n3. **Rules** \u2014 operational guardrails: which tools to call, what to echo, when to stop.\n4. **Exit condition** \u2014 what counts as success, what counts as a halt.\n\nIf you build a prompt that should live here, open a PR against `content/docs/agent-prompts.mdx`. Keep them under ~12 lines; if a workflow needs more, it belongs in a dedicated doc page and the prompt should link to it.\n'
+    "body": 'These prompts are deliberately terse. Each one names the canonical doc the agent should read first, the exact commands or [MCP tools](/docs/mcp) to call, and the exit condition. Replace `<angle-bracket>` placeholders before running.\n\nEvery prompt assumes the agent has either:\n\n- the [Cimplify CLI](/docs/cli) installed and `cimplify login` complete, **or**\n- an MCP connection to `https://api.cimplify.io/mcp` ([setup](/docs/mcp#connect))\n\n## Ship a new storefront end-to-end\n\n```text title="Scaffold \u2192 deploy \u2192 custom domain"\nSet up a Cimplify <retail> storefront called <my-store> and deploy it to <shop.example.com>.\n\nSource of truth: https://cimplify.dev/docs/tldr\n- Use the MCP tools at api.cimplify.io/mcp when available; otherwise shell `cimplify <cmd> --json`.\n- After every command, echo the JSON envelope.\n- Stop on the first non-zero exit code and name it from https://cimplify.dev/docs/cli#exit-codes.\n- Poll deployment status with cimplify_get_deployment_status (or `cimplify status --json`); never `sleep`.\n- Idempotent \u2014 re-running any step is safe.\n```\n\n## Rebrand an existing storefront\n\n```text title="Apply a new brand to a scaffolded template"\nRebrand the storefront in <./my-store> to match these tokens:\n  name: <Acme Coffee>\n  primary: <#0F172A>\n  accent: <#F59E0B>\n  fontDisplay: <"Playfair Display">\n  fontBody: <"Inter">\n\nRules (https://cimplify.dev/docs/templates/brand):\n- Single source of truth is `lib/brand.ts`. Update it first.\n- Mirror color tokens into `app/globals.css` `@theme` block. Do not hard-code colors elsewhere.\n- Do not edit ejected SDK components; they pick up tokens automatically.\n- Run `bun run check:brand` after edits; fix any schema errors it reports.\n- Verify by opening `http://localhost:3000` (start `bun dev` if not running).\n- Commit with message `brand: <name>`. Do not deploy.\n```\n\n## Add a homepage section\n\n```text title="New Server Component section, cache-tagged"\nAdd a `<Stories>` section to the homepage of the storefront in <./my-store>.\n\nPattern (mirrors the Server Component sections under `app/_sections/` in the scaffolded template):\n- Create `app/_sections/stories.tsx` as an async Server Component. Pass `cacheOptions: { revalidate: 3600, tags: [tags.collections()] }` to the SDK read (from `@cimplify/sdk/server`). Do NOT use `\'use cache\'` / `cacheTag` / `cacheLife` \u2014 Cimplify storefronts run on CF Workers where Cache Components is broken; use the ISR Previous Model.\n- Source data from `client.catalogue.getCollection({ slug: "stories" })`.\n- Render with the existing `<SectionHeader>` and `<ProductCard>` SDK components (do not eject).\n- Insert into `app/page.tsx` between the hero and the featured collection.\n- Run `bun run check` \u2014 must pass typecheck, lint, brand, cart-flow, contract.\n- Do not modify `lib/brand.ts` or any file under `components/ui/`.\n```\n\n## Migrate to a new SDK version\n\n```text title="SDK upgrade with breaking-change scan"\nUpgrade the storefront in <./my-store> from `@cimplify/sdk@<0.44.x>` to `@cimplify/sdk@<latest>`.\n\nProcess:\n- Read the release notes for the target range (`npm view @cimplify/sdk versions --json` to list, then `npm view @cimplify/sdk@<version>` per release).\n- Bump the pin in `package.json`, run `bun install`.\n- For each breaking change called out in the changelog, grep the project for the old symbol and apply the documented replacement.\n- Run `bun run check`. If `check:contract` fails, the SDK \u2194 mock contract drifted \u2014 stop and report.\n- Do not run `cimplify deploy`. End by printing a summary of every file you changed and every breaking change you applied.\n```\n\n## Add a custom checkout payment method\n\n```text title="Wire an additional payment option"\nAdd <mobile_money> as a checkout payment option in the storefront at <./my-store>.\n\nReference: https://cimplify.dev/docs/api-reference/checkout (flat ProcessArgs body \u2014 top-level fields, not nested).\n- The body shape is the contract \u2014 never wrap fields.\n- Eject the existing `<PaymentMethodPicker>` component with `cimplify add payment-method-picker`.\n- Add the option in the ejected picker, wiring the provider-specific body (e.g. `mobile_money_details: { phone_number, provider }`).\n- Validate the body against the typed `ProcessArgs` from `@cimplify/sdk`.\n- Run `bun run check:cart` \u2014 the add\u2192checkout flow must still pass.\n```\n\n## Provision a CI deploy key\n\n```text title="One-time setup for headless deploys"\nCreate a CI-scoped API key for the Cimplify project linked at <./my-store>, and write the GitHub Actions snippet that uses it.\n\nSteps:\n- Confirm `.cimplify/project.json` exists; if not, fail with NOT_LINKED (exit 4).\n- Print the dashboard URL the human needs to visit to create the key (https://app.cimplify.io/settings/developer).\n- Once the user provides `dk_live_\u2026`, store it as a repo secret named `CIMPLIFY_API_KEY` (instruct, do not perform).\n- Write `.github/workflows/deploy.yml` that runs on push to main: install CLI via the curl one-liner, `cimplify deploy --prod --api-key "$CIMPLIFY_API_KEY" --yes --json`.\n- Print the exit-code legend from https://cimplify.dev/docs/cli#exit-codes so the workflow can map failures.\n```\n\n## Diagnose a deploy that didn\'t go live\n\n```text title="Triage a failed or stuck deployment"\nThe latest deploy of the project at <./my-store> isn\'t live. Find out why.\n\nTriage path:\n- `cimplify status --json` \u2014 what\'s the latest deployment_id and status?\n- If status is `failed`, `cimplify logs --deployment <id> --json | tail -200`. Quote the first error line you see.\n- If status is `queued` or `building` for >5 minutes, the build is stuck \u2014 try `cimplify rollback <previous-deploy-id>`.\n- If status is `superseded` (exit 2), a newer push raced it; usually fine \u2014 confirm with `cimplify status` again.\n- If domains misroute, `cimplify domains ls --json` \u2014 confirm the verified+attached domain.\n- Report: deployment_id, status, the failing log line (if any), and the recommended next action. Do not auto-rollback without confirming.\n```\n\n## Add a hero image and reference it in the homepage\n\n```text title="Upload brand assets \u2192 use them in source"\nAdd the image at <./Downloads/hero.jpg> as the homepage hero for the storefront in <./my-store>.\n\nReference: https://cimplify.dev/docs/cli/assets\n- `cp <./Downloads/hero.jpg> public/hero/main.jpg`\n- `cimplify assets upload public/hero/ --folder hero --json` \u2014 captures the manifest entry for `hero/main.jpg`.\n- Edit `app/page.tsx`: replace the hero `<Image>` `src` with `assetUrl("hero/main.jpg")` from `@cimplify/sdk`.\n- Do NOT touch existing `<Image>` calls that point at Cloudinary or other external hosts \u2014 the loader passes them through unchanged.\n- Run `bun run check`. Open `http://localhost:3000`; verify the hero image renders.\n- Commit `cimplify-assets.json` along with the source change so the manifest is reviewable.\n```\n\n## Audit caching and asset delivery\n\n```text title="Find caching and asset regressions on a live storefront"\nAudit the live storefront at <https://my-store.mycimplify.com> for caching and asset-delivery regressions.\n\nSources of truth:\n- https://cimplify.dev/docs/sdk/optimization (page + asset caching)\n- https://cimplify.dev/docs/templates/seo-and-resource-hints (responsive images)\n\n- Page cache: curl /, /shop, and a PDP 2\u20133\xD7 each; `X-Cimplify-Edge-Cache` must warm to HIT and `Cache-Control` must carry `s-maxage`. A BYPASS or missing `s-maxage` means the page lost its `revalidate` or carries a Cookie.\n- Asset cache: pull a `/_next/static/*` chunk \u2014 it must be `public, max-age=31536000, immutable`.\n- Images: flag raw `<img>` from a third-party CDN, and Cloudinary URLs with no `/upload/<transform>/` segment (full-resolution originals).\n- Report a table (route/asset, observed header, expected, severity). Do not change source unless asked.\n```\n\n## Reset a sandbox storefront to a clean state\n\n```text title="Wipe and re-seed for repeatable demos"\nReset the local mock state for the storefront in <./my-store>.\n\n- Stop any running `bun dev` process.\n- `cimplify mock reset` (clears the in-process mock backing store).\n- `cimplify mock seed <retail>` (re-seeds with the chosen industry fixture).\n- `bun dev` to restart both servers.\n- Verify: `curl localhost:8787/v1/catalogue/products | jq \'.data | length\'` returns the expected seed count (~24 for retail).\n- Do not touch the linked cloud project; this is local-only.\n```\n\n## How these are built\n\nEvery prompt above is structured the same way so you can adapt them:\n\n1. **Goal** \u2014 one sentence, with `<angle-bracket>` placeholders for the moving parts.\n2. **Source of truth** \u2014 the canonical doc URL the agent reads first.\n3. **Rules** \u2014 operational guardrails: which tools to call, what to echo, when to stop.\n4. **Exit condition** \u2014 what counts as success, what counts as a halt.\n\nIf you build a prompt that should live here, open a PR against `content/docs/agent-prompts.mdx`. Keep them under ~12 lines; if a workflow needs more, it belongs in a dedicated doc page and the prompt should link to it.\n'
   },
   {
     "name": "seeds",

package/dist/{introspect-HWOZIVET.mjs → introspect-ZS6I46OO.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-export { run as default, extractMockSeed, gatherIntrospection, renderIntrospection } from './chunk-OJRMBHMT.mjs';
+export { run as default, extractMockSeed, gatherIntrospection, renderIntrospection } from './chunk-MR3Q43SU.mjs';
 import './chunk-K5464A3L.mjs';
 import './chunk-DBZ3UOQ2.mjs';
-import './chunk-NIDPHJ45.mjs';
+import './chunk-GAN7PG6N.mjs';
 import './chunk-C4M3DXKC.mjs';
 import './chunk-UBAI443T.mjs';
 import './chunk-E2T2SBP5.mjs';

package/dist/{list-WC7JWDCJ.mjs → list-P74FSKQR.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { REGISTRY_INDEX } from './chunk-XKO2EB5J.mjs';
+import { REGISTRY_INDEX } from './chunk-HWHV62KB.mjs';
 import { parseArgs, flagBool } from './chunk-C4M3DXKC.mjs';
 import { CliError, CLI_ERROR_CODE, info, bold, dim, green, result } from './chunk-E2T2SBP5.mjs';
 

package/dist/{projects-JSEC2YCX.mjs → projects-QSUWVTJZ.mjs}

@@ -11,7 +11,11 @@ var SUB_LIST = "list";
 var SUB_CREATE = "create";
 var FLAG_NO_REPO = "no-repo";
 var FLAG_CONNECT = "connect";
-var PROJECT_TYPE_DEFAULT = "nextjs-app";
+var FLAG_FRAMEWORK = "framework";
+var PROJECT_FRAMEWORK_NEXTJS = "nextjs";
+var PROJECT_FRAMEWORK_TANSTACK_START = "tanstack-start";
+var PROJECT_TYPE_NEXTJS = "nextjs-app";
+var PROJECT_TYPE_TANSTACK_START = "tanstack-start";
 var COL_GAP = "  ";
 function projectsEndpoint(businessId) {
   return `/v1/businesses/${encodeURIComponent(businessId)}/projects`;
@@ -56,12 +60,13 @@ async function run(argv) {
     if (!name) {
       throw new CliError(
         CLI_ERROR_CODE.INVALID_INPUT,
-        `Usage: cimplify projects ${SUB_CREATE} <name> [--no-repo | --connect <url>]`
+        `Usage: cimplify projects ${SUB_CREATE} <name> [--framework <nextjs|tanstack-start>] [--no-repo | --connect <url>]`
       );
     }
     await createProject(client, auth.businessId, name, {
       noRepo: flagBool(args, FLAG_NO_REPO),
-      connectRemote: flagString(args, FLAG_CONNECT)
+      connectRemote: flagString(args, FLAG_CONNECT),
+      framework: parseProjectFramework(flagString(args, FLAG_FRAMEWORK))
     });
     return;
   }
@@ -102,6 +107,21 @@ async function listProjects(client, businessId) {
     }))
   });
 }
+function parseProjectFramework(value) {
+  if (!value || value === PROJECT_FRAMEWORK_NEXTJS || value === PROJECT_TYPE_NEXTJS) {
+    return PROJECT_FRAMEWORK_NEXTJS;
+  }
+  if (value === PROJECT_FRAMEWORK_TANSTACK_START || value === "tanstack") {
+    return PROJECT_FRAMEWORK_TANSTACK_START;
+  }
+  throw new CliError(
+    CLI_ERROR_CODE.INVALID_INPUT,
+    `Unknown framework "${value}". Valid options: nextjs, tanstack-start.`
+  );
+}
+function projectTypeForFramework(framework) {
+  return framework === PROJECT_FRAMEWORK_TANSTACK_START ? PROJECT_TYPE_TANSTACK_START : PROJECT_TYPE_NEXTJS;
+}
 async function createProject(client, businessId, name, options = {}) {
   if (options.noRepo && options.connectRemote) {
     throw new CliError(
@@ -109,7 +129,10 @@ async function createProject(client, businessId, name, options = {}) {
       "Cannot pass both --no-repo and --connect."
     );
   }
-  const body = { name, project_type: PROJECT_TYPE_DEFAULT };
+  const body = {
+    name,
+    project_type: projectTypeForFramework(options.framework ?? PROJECT_FRAMEWORK_NEXTJS)
+  };
   const project = await client.post(projectsEndpoint(businessId), body);
   success(`Created project ${project.name} (${project.id})`);
   if (options.noRepo) {

package/dist/{update-6LL5PQEQ.mjs → update-E6Q3KV3B.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { package_default } from './chunk-NIDPHJ45.mjs';
+import { package_default } from './chunk-GAN7PG6N.mjs';
 import { promptYesNo } from './chunk-ITAFAORS.mjs';
 import { parseArgs, flagBool, flagString } from './chunk-C4M3DXKC.mjs';
 import { success, bold, info, dim, result, failure, CliError, CLI_ERROR_CODE, step, isJsonMode } from './chunk-E2T2SBP5.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/cli",
-  "version": "0.7.17",
+  "version": "0.7.18",
   "description": "Cimplify CLI — deploy, manage env vars, link projects, and scaffold storefronts",
   "keywords": [
     "cimplify",
@@ -45,6 +45,6 @@
     "vitest": "^4.1.5"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.70.3"
+    "@cimplify/sdk": "^0.72.0"
   }
 }

package/templates/storefront-auto/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { Inter, JetBrains_Mono } from "next/font/google";
 import "./globals.css";
 import { Providers } from "@/components/providers";
+import { getServerClient, tags } from "@cimplify/sdk/server";
 import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
@@ -41,7 +42,15 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const server = getServerClient();
+  const [bizResult, locResult] = await Promise.all([
+    server.business.getInfo({ cacheOptions: { revalidate: 3600, tags: [tags.business()] } }),
+    server.business.getLocations({ cacheOptions: { revalidate: 3600, tags: [tags.locations()] } }),
+  ]);
+  const initialBusiness = bizResult.ok ? bizResult.value : null;
+  const initialLocations = locResult.ok ? locResult.value : [];
+
   return (
     <html lang="en" suppressHydrationWarning className={`${inter.variable} ${mono.variable}`}>
       <body
@@ -51,7 +60,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         <Suspense fallback={null}>
           <OrganizationJsonLd />
         </Suspense>
-        <Providers>
+        <Providers initialBusiness={initialBusiness} initialLocations={initialLocations}>
           <Header />
           <main className="flex-1 pb-12 w-full">
             <Suspense fallback={null}>{children}</Suspense>

package/templates/storefront-auto/components/providers.tsx

@@ -1,13 +1,23 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
-import { createCimplifyClient } from "@cimplify/sdk";
+import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
 
 // Same-origin client — every request goes through the Next.js rewrite in
 // next.config.ts, so no CORS preflight ever hits the browser.
-export function Providers({ children }: { children: ReactNode }) {
+export function Providers({
+  children,
+  initialBusiness,
+  initialLocations,
+}: {
+  children: ReactNode;
+  // Server-fetched in app/layout.tsx so prices render in the right currency
+  // during SSR (no default-currency flash before the client bootstrap).
+  initialBusiness?: Business | null;
+  initialLocations?: Location[];
+}) {
   const client = useMemo(() => {
     const baseUrl =
       typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787";
@@ -20,7 +30,11 @@ export function Providers({ children }: { children: ReactNode }) {
   }, []);
 
   return (
-    <CimplifyProvider client={client}>
+    <CimplifyProvider
+      client={client}
+      initialBusiness={initialBusiness}
+      initialLocations={initialLocations}
+    >
       <CartDrawerProvider>
         {children}
         <AuthErrorToast />

package/templates/storefront-auto/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.70.3",
+    "@cimplify/sdk": "^0.72.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-bakery/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { Inter, Playfair_Display } from "next/font/google";
 import "./globals.css";
 import { Providers } from "@/components/providers";
+import { getServerClient, tags } from "@cimplify/sdk/server";
 import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
@@ -41,7 +42,15 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const server = getServerClient();
+  const [bizResult, locResult] = await Promise.all([
+    server.business.getInfo({ cacheOptions: { revalidate: 3600, tags: [tags.business()] } }),
+    server.business.getLocations({ cacheOptions: { revalidate: 3600, tags: [tags.locations()] } }),
+  ]);
+  const initialBusiness = bizResult.ok ? bizResult.value : null;
+  const initialLocations = locResult.ok ? locResult.value : [];
+
   return (
     <html lang="en" suppressHydrationWarning className={`${inter.variable} ${playfair.variable}`}>
       <body
@@ -51,7 +60,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         <Suspense fallback={null}>
           <OrganizationJsonLd />
         </Suspense>
-        <Providers>
+        <Providers initialBusiness={initialBusiness} initialLocations={initialLocations}>
           <Header />
           <main className="flex-1 pb-12 w-full">
             <Suspense fallback={null}>{children}</Suspense>

package/templates/storefront-bakery/components/providers.tsx

@@ -1,13 +1,23 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
-import { createCimplifyClient } from "@cimplify/sdk";
+import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
 
 // Same-origin client — every request goes through the Next.js rewrite in
 // next.config.ts, so no CORS preflight ever hits the browser.
-export function Providers({ children }: { children: ReactNode }) {
+export function Providers({
+  children,
+  initialBusiness,
+  initialLocations,
+}: {
+  children: ReactNode;
+  // Server-fetched in app/layout.tsx so prices render in the right currency
+  // during SSR (no default-currency flash before the client bootstrap).
+  initialBusiness?: Business | null;
+  initialLocations?: Location[];
+}) {
   const client = useMemo(() => {
     const baseUrl =
       typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787";
@@ -20,7 +30,11 @@ export function Providers({ children }: { children: ReactNode }) {
   }, []);
 
   return (
-    <CimplifyProvider client={client}>
+    <CimplifyProvider
+      client={client}
+      initialBusiness={initialBusiness}
+      initialLocations={initialLocations}
+    >
       <CartDrawerProvider>
         {children}
         <AuthErrorToast />

package/templates/storefront-bakery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.70.3",
+    "@cimplify/sdk": "^0.72.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-fashion/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { Inter, Anton } from "next/font/google";
 import "./globals.css";
 import { Providers } from "@/components/providers";
+import { getServerClient, tags } from "@cimplify/sdk/server";
 import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
@@ -42,7 +43,15 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const server = getServerClient();
+  const [bizResult, locResult] = await Promise.all([
+    server.business.getInfo({ cacheOptions: { revalidate: 3600, tags: [tags.business()] } }),
+    server.business.getLocations({ cacheOptions: { revalidate: 3600, tags: [tags.locations()] } }),
+  ]);
+  const initialBusiness = bizResult.ok ? bizResult.value : null;
+  const initialLocations = locResult.ok ? locResult.value : [];
+
   return (
     <html lang="en" suppressHydrationWarning className={`${inter.variable} ${anton.variable}`}>
       <body
@@ -52,7 +61,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         <Suspense fallback={null}>
           <OrganizationJsonLd />
         </Suspense>
-        <Providers>
+        <Providers initialBusiness={initialBusiness} initialLocations={initialLocations}>
           <Header />
           <main className="flex-1 pb-12 w-full">
             <Suspense fallback={null}>{children}</Suspense>

package/templates/storefront-fashion/components/providers.tsx

@@ -1,13 +1,23 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
-import { createCimplifyClient } from "@cimplify/sdk";
+import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
 
 // Same-origin client — every request goes through the Next.js rewrite in
 // next.config.ts, so no CORS preflight ever hits the browser.
-export function Providers({ children }: { children: ReactNode }) {
+export function Providers({
+  children,
+  initialBusiness,
+  initialLocations,
+}: {
+  children: ReactNode;
+  // Server-fetched in app/layout.tsx so prices render in the right currency
+  // during SSR (no default-currency flash before the client bootstrap).
+  initialBusiness?: Business | null;
+  initialLocations?: Location[];
+}) {
   const client = useMemo(() => {
     const baseUrl =
       typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787";
@@ -20,7 +30,11 @@ export function Providers({ children }: { children: ReactNode }) {
   }, []);
 
   return (
-    <CimplifyProvider client={client}>
+    <CimplifyProvider
+      client={client}
+      initialBusiness={initialBusiness}
+      initialLocations={initialLocations}
+    >
       <CartDrawerProvider>
         {children}
         <AuthErrorToast />

package/templates/storefront-fashion/package.json

@@ -19,7 +19,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.70.3",
+    "@cimplify/sdk": "^0.72.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-grocery/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { Inter } from "next/font/google";
 import "./globals.css";
 import { Providers } from "@/components/providers";
+import { getServerClient, tags } from "@cimplify/sdk/server";
 import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
@@ -35,7 +36,15 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const server = getServerClient();
+  const [bizResult, locResult] = await Promise.all([
+    server.business.getInfo({ cacheOptions: { revalidate: 3600, tags: [tags.business()] } }),
+    server.business.getLocations({ cacheOptions: { revalidate: 3600, tags: [tags.locations()] } }),
+  ]);
+  const initialBusiness = bizResult.ok ? bizResult.value : null;
+  const initialLocations = locResult.ok ? locResult.value : [];
+
   return (
     <html lang="en" suppressHydrationWarning className={inter.variable}>
       <body
@@ -45,7 +54,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         <Suspense fallback={null}>
           <OrganizationJsonLd />
         </Suspense>
-        <Providers>
+        <Providers initialBusiness={initialBusiness} initialLocations={initialLocations}>
           <Header />
           <main className="flex-1 pb-12 w-full">
             <Suspense fallback={null}>{children}</Suspense>

package/templates/storefront-grocery/components/providers.tsx

@@ -1,13 +1,23 @@
 "use client";
 
 import { useMemo, type ReactNode } from "react";
-import { createCimplifyClient } from "@cimplify/sdk";
+import { createCimplifyClient, type Business, type Location } from "@cimplify/sdk";
 import { CimplifyProvider, CartDrawerProvider } from "@cimplify/sdk/react";
 import { AuthErrorToast } from "@/components/auth-error-toast";
 
 // Same-origin client — every request goes through the Next.js rewrite in
 // next.config.ts, so no CORS preflight ever hits the browser.
-export function Providers({ children }: { children: ReactNode }) {
+export function Providers({
+  children,
+  initialBusiness,
+  initialLocations,
+}: {
+  children: ReactNode;
+  // Server-fetched in app/layout.tsx so prices render in the right currency
+  // during SSR (no default-currency flash before the client bootstrap).
+  initialBusiness?: Business | null;
+  initialLocations?: Location[];
+}) {
   const client = useMemo(() => {
     const baseUrl =
       typeof window !== "undefined" ? window.location.origin : "http://127.0.0.1:8787";
@@ -20,7 +30,11 @@ export function Providers({ children }: { children: ReactNode }) {
   }, []);
 
   return (
-    <CimplifyProvider client={client}>
+    <CimplifyProvider
+      client={client}
+      initialBusiness={initialBusiness}
+      initialLocations={initialLocations}
+    >
       <CartDrawerProvider>
         {children}
         <AuthErrorToast />

package/templates/storefront-grocery/package.json

@@ -17,7 +17,7 @@
     "check": "bun run typecheck && bun run test:run"
   },
   "dependencies": {
-    "@cimplify/sdk": "^0.70.3",
+    "@cimplify/sdk": "^0.72.0",
     "next": "^16.2.6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/templates/storefront-pharmacy/app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata } from "next";
 import { Inter, JetBrains_Mono } from "next/font/google";
 import "./globals.css";
 import { Providers } from "@/components/providers";
+import { getServerClient, tags } from "@cimplify/sdk/server";
 import { Header } from "@/components/header";
 import { Footer } from "@/components/footer";
 import { ProductModal } from "@/components/product-modal";
@@ -41,7 +42,15 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default function RootLayout({ children }: { children: React.ReactNode }) {
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  const server = getServerClient();
+  const [bizResult, locResult] = await Promise.all([
+    server.business.getInfo({ cacheOptions: { revalidate: 3600, tags: [tags.business()] } }),
+    server.business.getLocations({ cacheOptions: { revalidate: 3600, tags: [tags.locations()] } }),
+  ]);
+  const initialBusiness = bizResult.ok ? bizResult.value : null;
+  const initialLocations = locResult.ok ? locResult.value : [];
+
   return (
     <html lang="en" suppressHydrationWarning className={`${inter.variable} ${mono.variable}`}>
       <body
@@ -51,7 +60,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
         <Suspense fallback={null}>
           <OrganizationJsonLd />
         </Suspense>
-        <Providers>
+        <Providers initialBusiness={initialBusiness} initialLocations={initialLocations}>
           <Header />
           <main className="flex-1 pb-12 w-full">
             <Suspense fallback={null}>{children}</Suspense>