create-brainerce-store 1.62.0 → 1.63.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-brainerce-store",
-  "version": "1.62.0",
+  "version": "1.63.0",
   "description": "Scaffold a production-ready e-commerce storefront connected to Brainerce",
   "bin": {
     "create-brainerce-store": "dist/index.js"

package/templates/nextjs/base/.claude/commands/design.md

@@ -1,60 +1,60 @@
----
-description: Redesign this storefront's presentation layer to a distinctive, production-grade look
----
-
-You are the design lead for this Brainerce storefront. Design brief from the
-merchant: **$ARGUMENTS** (if empty, ask for a one-line direction first — e.g.
-"dark cinematic jewelry gallery", "brutalist streetwear", "warm Mediterranean
-boutique").
-
-## Rebuild, don't restyle
-
-The shipped `src/ui/` is a WORKING REFERENCE, not an aesthetic to preserve.
-(In a `--canvas` scaffold it's already a bare unstyled skeleton — each
-component carries a `DESIGN ME` marker telling you what the surface is and
-which hook feeds it; skip straight to designing.)
-You are expected to design from scratch: deleting entire files under
-`src/ui/` and rebuilding them around the same hooks is encouraged — that is
-what the folder exists for. Do not inherit the current look's layout,
-spacing, or component structure unless it genuinely serves your direction.
-Build the store YOU would build; the reference only shows which hooks feed
-which surface.
-
-## Ground rules (non-negotiable)
-
-1. Read `AI-GUIDE.md` and `src/ui/`'s current structure BEFORE writing code.
-2. You may rewrite anything in `src/ui/**` and `src/app/globals.css`, and
-   wire new ui components in the thin `src/app/**` routes. You may NOT touch
-   `src/core/**`, `src/app/api/**`, or checkout/auth/account components.
-3. All data via `@/core/hooks/*` and the store provider — no hardcoded
-   products, prices, or currency symbols.
-4. All copy via `useTranslations()`, keys added to every file in `messages/`.
-
-## The process
-
-## The quality bar (non-negotiable — from the AI-GUIDE)
-
-Exactly 3-5 colors (no purple unless asked, no gradients by default), max 2
-font families, tokens-only colors, Tailwind spacing scale, real imagery
-(never abstract filler), content-rich sections, mobile-first. After EACH
-major surface: screenshot → self-critique ("would a Lovable user accept
-this?") → fix → continue. See AI-GUIDE.md "The quality bar".
-
-
-1. **Commit to ONE art direction** — write it down in 4 lines (typography
-   pairing incl. a script-compatible webfont, 6-10 color tokens, layout
-   concept, motion language) at the top of `DESIGN.md` in the project root.
-   Bold and specific beats safe and generic; do not hedge toward the middle.
-2. **Tokens first**: rewrite `globals.css` custom properties + font loading
-   in the locale layout.
-3. **Surfaces in order**: header/footer → homepage sections → product card +
-   grid → product page → cart. Keep each step compiling.
-4. **Micro-details**: hover states, loading states, one signature
-   interaction. Wrap all motion in `prefers-reduced-motion` guards.
-5. **Verify** (mandatory): `pnpm exec tsc --noEmit` = 0, then `pnpm dev` and
-   drive home → product → add-to-cart → cart in a real browser; screenshot
-   desktop (1440) AND mobile (390). For RTL locales check anchoring and
-   arrow directions. Fix what looks off before reporting.
-
-Report with: the direction chosen, what changed, screenshots, and anything
-that needs merchant input (e.g. brand name, logo, photography).
+---
+description: Redesign this storefront's presentation layer to a distinctive, production-grade look
+---
+
+You are the design lead for this Brainerce storefront. Design brief from the
+merchant: **$ARGUMENTS** (if empty, ask for a one-line direction first — e.g.
+"dark cinematic jewelry gallery", "brutalist streetwear", "warm Mediterranean
+boutique").
+
+## Rebuild, don't restyle
+
+The shipped `src/ui/` is a WORKING REFERENCE, not an aesthetic to preserve.
+(In a `--canvas` scaffold it's already a bare unstyled skeleton — each
+component carries a `DESIGN ME` marker telling you what the surface is and
+which hook feeds it; skip straight to designing.)
+You are expected to design from scratch: deleting entire files under
+`src/ui/` and rebuilding them around the same hooks is encouraged — that is
+what the folder exists for. Do not inherit the current look's layout,
+spacing, or component structure unless it genuinely serves your direction.
+Build the store YOU would build; the reference only shows which hooks feed
+which surface.
+
+## Ground rules (non-negotiable)
+
+1. Read `AI-GUIDE.md` and `src/ui/`'s current structure BEFORE writing code.
+2. You may rewrite anything in `src/ui/**` and `src/app/globals.css`, and
+   wire new ui components in the thin `src/app/**` routes. You may NOT touch
+   `src/core/**`, `src/app/api/**`, or checkout/auth/account components.
+3. All data via `@/core/hooks/*` and the store provider — no hardcoded
+   products, prices, or currency symbols.
+4. All copy via `useTranslations()`, keys added to every file in `messages/`.
+
+## The process
+
+## The quality bar (non-negotiable — from the AI-GUIDE)
+
+Exactly 3-5 colors (no purple unless asked, no gradients by default), max 2
+font families, tokens-only colors, Tailwind spacing scale, real imagery
+(never abstract filler), content-rich sections, mobile-first. After EACH
+major surface: screenshot → self-critique ("would a Lovable user accept
+this?") → fix → continue. See AI-GUIDE.md "The quality bar".
+
+
+1. **Commit to ONE art direction** — write it down in 4 lines (typography
+   pairing incl. a script-compatible webfont, 6-10 color tokens, layout
+   concept, motion language) at the top of `DESIGN.md` in the project root.
+   Bold and specific beats safe and generic; do not hedge toward the middle.
+2. **Tokens first**: rewrite `globals.css` custom properties + font loading
+   in the locale layout.
+3. **Surfaces in order**: header/footer → homepage sections → product card +
+   grid → product page → cart. Keep each step compiling.
+4. **Micro-details**: hover states, loading states, one signature
+   interaction. Wrap all motion in `prefers-reduced-motion` guards.
+5. **Verify** (mandatory): `pnpm exec tsc --noEmit` = 0, then `pnpm dev` and
+   drive home → product → add-to-cart → cart in a real browser; screenshot
+   desktop (1440) AND mobile (390). For RTL locales check anchoring and
+   arrow directions. Fix what looks off before reporting.
+
+Report with: the direction chosen, what changed, screenshots, and anything
+that needs merchant input (e.g. brand name, logo, photography).

package/templates/nextjs/base/.env.local.ejs

@@ -1,24 +1,24 @@
-# Brainerce Sales Channel — preferred env var name.
-NEXT_PUBLIC_BRAINERCE_SALES_CHANNEL_ID=<%= connectionId %>
-# Legacy alias kept for backwards compatibility — both are accepted by the SDK.
-# @deprecated will be removed when SDK 2.0 ships.
-NEXT_PUBLIC_BRAINERCE_CONNECTION_ID=<%= connectionId %>
-
-# Store info (pre-fetched during setup to avoid flash on first load)
-NEXT_PUBLIC_STORE_NAME=<%- storeNameEnv %>
-NEXT_PUBLIC_STORE_CURRENCY=<%- currencyEnv %>
-
-# Backend API URL (server-side only — used by BFF proxy and SSR, never exposed to browser)
-BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
-
-# Public API origin for the AI chat widget (public, unauthenticated endpoints only).
-# The widget streams chat directly from the browser, so this one IS public.
-NEXT_PUBLIC_BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
-
-# Public site URL — used for sitemap, robots.txt, and SEO metadata
-NEXT_PUBLIC_SITE_URL=http://localhost:3000
-
-# Optional: floating WhatsApp contact button (used by some designs, e.g.
-# passepartout). Digits only, international format without "+"
-# (e.g. 14155550123). Leave unset to hide the button.
-# NEXT_PUBLIC_WHATSAPP_PHONE=
+# Brainerce Sales Channel — preferred env var name.
+NEXT_PUBLIC_BRAINERCE_SALES_CHANNEL_ID=<%= connectionId %>
+# Legacy alias kept for backwards compatibility — both are accepted by the SDK.
+# @deprecated will be removed when SDK 2.0 ships.
+NEXT_PUBLIC_BRAINERCE_CONNECTION_ID=<%= connectionId %>
+
+# Store info (pre-fetched during setup to avoid flash on first load)
+NEXT_PUBLIC_STORE_NAME=<%- storeNameEnv %>
+NEXT_PUBLIC_STORE_CURRENCY=<%- currencyEnv %>
+
+# Backend API URL (server-side only — used by BFF proxy and SSR, never exposed to browser)
+BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
+
+# Public API origin for the AI chat widget (public, unauthenticated endpoints only).
+# The widget streams chat directly from the browser, so this one IS public.
+NEXT_PUBLIC_BRAINERCE_API_URL=<%- apiBaseUrlEnv %>
+
+# Public site URL — used for sitemap, robots.txt, and SEO metadata
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
+
+# Optional: floating WhatsApp contact button (used by some designs, e.g.
+# passepartout). Digits only, international format without "+"
+# (e.g. 14155550123). Leave unset to hide the button.
+# NEXT_PUBLIC_WHATSAPP_PHONE=

package/templates/nextjs/base/.eslintrc.json

@@ -1,57 +1,57 @@
-{
-  "extends": [
-    "next/core-web-vitals"
-  ],
-  "overrides": [
-    {
-      "files": [
-        "src/ui/**/*.{ts,tsx}"
-      ],
-      "rules": {
-        "no-restricted-imports": [
-          "error",
-          {
-            "patterns": [
-              {
-                "group": [
-                  "@/core/lib/*",
-                  "!@/core/lib/auth",
-                  "!@/core/lib/brainerce",
-                  "!@/core/lib/image-hosts",
-                  "!@/core/lib/navigation",
-                  "!@/core/lib/product-options",
-                  "!@/core/lib/sanitize",
-                  "!@/core/lib/sanitize-html",
-                  "!@/core/lib/translations",
-                  "!@/core/lib/use-currency",
-                  "!@/core/lib/utils"
-                ],
-                "message": "UI consumes data via @/core/hooks/* and @/core/providers/* — not core internals. (Approved presentation helpers are exempt.)"
-              }
-            ]
-          }
-        ]
-      }
-    },
-    {
-      "files": [
-        "src/core/**/*.{ts,tsx}"
-      ],
-      "rules": {
-        "no-restricted-imports": [
-          "error",
-          {
-            "patterns": [
-              {
-                "group": [
-                  "@/ui/*"
-                ],
-                "message": "core/ must never depend on presentation (ui/)."
-              }
-            ]
-          }
-        ]
-      }
-    }
-  ]
-}
+{
+  "extends": [
+    "next/core-web-vitals"
+  ],
+  "overrides": [
+    {
+      "files": [
+        "src/ui/**/*.{ts,tsx}"
+      ],
+      "rules": {
+        "no-restricted-imports": [
+          "error",
+          {
+            "patterns": [
+              {
+                "group": [
+                  "@/core/lib/*",
+                  "!@/core/lib/auth",
+                  "!@/core/lib/brainerce",
+                  "!@/core/lib/image-hosts",
+                  "!@/core/lib/navigation",
+                  "!@/core/lib/product-options",
+                  "!@/core/lib/sanitize",
+                  "!@/core/lib/sanitize-html",
+                  "!@/core/lib/translations",
+                  "!@/core/lib/use-currency",
+                  "!@/core/lib/utils"
+                ],
+                "message": "UI consumes data via @/core/hooks/* and @/core/providers/* — not core internals. (Approved presentation helpers are exempt.)"
+              }
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "files": [
+        "src/core/**/*.{ts,tsx}"
+      ],
+      "rules": {
+        "no-restricted-imports": [
+          "error",
+          {
+            "patterns": [
+              {
+                "group": [
+                  "@/ui/*"
+                ],
+                "message": "core/ must never depend on presentation (ui/)."
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}

package/templates/nextjs/base/.mcp.json

@@ -1,8 +1,8 @@
-{
-  "mcpServers": {
-    "brainerce-docs": {
-      "type": "http",
-      "url": "https://mcp-docs.brainerce.com/mcp"
-    }
-  }
-}
+{
+  "mcpServers": {
+    "brainerce-docs": {
+      "type": "http",
+      "url": "https://mcp-docs.brainerce.com/mcp"
+    }
+  }
+}