create-brainerce-store 1.50.1 → 1.51.0

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "create-brainerce-store",
-      version: "1.50.1",
+      version: "1.51.0",
       description: "Scaffold a production-ready e-commerce storefront connected to Brainerce",
       bin: {
         "create-brainerce-store": "dist/index.js"
@@ -178,7 +178,9 @@ var BRAINERCE_RUNTIME_DEPS = Object.freeze({
   // (Product.displayPrice / displayCurrency / displaySalePrice attached
   // additively when getProducts is called with a regionId). Scaffolded stores
   // must pin >=1.30 to get the auto-region + tax-estimate methods.
-  brainerce: "^1.32.0",
+  // 1.44 adds the order-level `notes` field to SetShippingAddressDto /
+  // SetCheckoutCustomerDto — the scaffolded checkout form types depend on it.
+  brainerce: "^1.44.0",
   "isomorphic-dompurify": "^3.8.0"
 });
 
@@ -286,66 +288,61 @@ async function runInteractive(defaults) {
       initial: 0
     });
   }
-  questions.push(
-    {
-      type: "select",
-      name: "framework",
-      message: "Framework:",
-      choices: [
-        { title: "Next.js 15 (recommended)", value: "nextjs" },
-        { title: "Vite + React (coming soon)", value: "vite", disabled: true },
-        { title: "Remix (coming soon)", value: "remix", disabled: true }
-      ],
-      initial: 0
-    },
-    {
+  questions.push({
+    type: "select",
+    name: "framework",
+    message: "Framework:",
+    choices: [
+      { title: "Next.js 15 (recommended)", value: "nextjs" },
+      { title: "Vite + React (coming soon)", value: "vite", disabled: true },
+      { title: "Remix (coming soon)", value: "remix", disabled: true }
+    ],
+    initial: 0
+  });
+  if (!defaults.canvas && !defaults.design) {
+    questions.push({
       type: "select",
-      name: "theme",
-      message: "Theme:",
+      name: "design",
+      message: "Design:",
       choices: [
         {
-          title: "Minimal",
-          description: "Clean, neutral design with Inter font",
-          value: "minimal"
+          title: "Passe-Partout \u2014 warm gallery minimal (recommended)",
+          description: "Framed product cards, placard PDP, print-serif titles",
+          value: "passepartout"
         },
         {
-          title: "Luxury",
-          description: "Dark, sophisticated design with Cormorant Garamond serif font",
-          value: "luxury"
-        },
-        {
-          title: "Playful",
-          description: "Warm, vibrant design with Nunito rounded font",
-          value: "playful"
+          title: "Minimal \u2014 bare clean base",
+          description: "Neutral tokens, unopinionated layout",
+          value: "minimal"
         }
       ],
       initial: 0
-    },
-    {
-      type: "select",
-      name: "pkgManager",
-      message: "Package manager:",
-      choices: [
-        {
-          title: `pnpm${detectInvokingPackageManager() === "pnpm" ? " (detected)" : ""}`,
-          value: "pnpm"
-        },
-        {
-          title: `npm${detectInvokingPackageManager() === "npm" ? " (detected)" : ""}`,
-          value: "npm"
-        },
-        {
-          title: `yarn${detectInvokingPackageManager() === "yarn" ? " (detected)" : ""}`,
-          value: "yarn"
-        },
-        {
-          title: `bun${detectInvokingPackageManager() === "bun" ? " (detected)" : ""}`,
-          value: "bun"
-        }
-      ],
-      initial: ["pnpm", "npm", "yarn", "bun"].indexOf(detectInvokingPackageManager())
-    }
-  );
+    });
+  }
+  questions.push({
+    type: "select",
+    name: "pkgManager",
+    message: "Package manager:",
+    choices: [
+      {
+        title: `pnpm${detectInvokingPackageManager() === "pnpm" ? " (detected)" : ""}`,
+        value: "pnpm"
+      },
+      {
+        title: `npm${detectInvokingPackageManager() === "npm" ? " (detected)" : ""}`,
+        value: "npm"
+      },
+      {
+        title: `yarn${detectInvokingPackageManager() === "yarn" ? " (detected)" : ""}`,
+        value: "yarn"
+      },
+      {
+        title: `bun${detectInvokingPackageManager() === "bun" ? " (detected)" : ""}`,
+        value: "bun"
+      }
+    ],
+    initial: ["pnpm", "npm", "yarn", "bun"].indexOf(detectInvokingPackageManager())
+  });
   const response = await (0, import_prompts.default)(questions, {
     onCancel: () => {
       throw new Error("PROMPT_CANCELLED");
@@ -357,6 +354,7 @@ async function runInteractive(defaults) {
     language: response.language || defaults.language || "en",
     framework: response.framework || defaults.framework || "nextjs",
     theme: response.theme || defaults.theme || "minimal",
+    design: response.design || defaults.design || "minimal",
     pkgManager: response.pkgManager || defaults.pkgManager || detectInvokingPackageManager()
   };
 }
@@ -459,6 +457,37 @@ async function scaffold(options) {
     isomorphicDompurifyVersion: BRAINERCE_RUNTIME_DEPS["isomorphic-dompurify"]
   };
   await copyWithEjs(baseDir, targetDir, templateVars);
+  if (options.canvas) {
+    const canvasDir = import_path.default.join(templatesRoot, framework, "ui-canvas");
+    if (!await import_fs_extra.default.pathExists(canvasDir)) {
+      throw new Error(`Canvas template not found at ${canvasDir}`);
+    }
+    const uiTarget = import_path.default.join(targetDir, "src", "ui");
+    await import_fs_extra.default.remove(uiTarget);
+    await copyWithEjs(canvasDir, uiTarget, templateVars);
+  }
+  const designName = options.design && options.design !== "minimal" ? options.design : null;
+  if (designName && !/^[a-z0-9-]+$/.test(designName)) {
+    throw new Error(`Invalid design name "${designName}"`);
+  }
+  const designDir = designName ? import_path.default.join(templatesRoot, framework, "designs", designName) : null;
+  if (designName && !options.canvas) {
+    if (!designDir || !await import_fs_extra.default.pathExists(designDir)) {
+      throw new Error(`Design "${designName}" not found at ${designDir}`);
+    }
+    const designUi = import_path.default.join(designDir, "ui");
+    if (await import_fs_extra.default.pathExists(designUi)) {
+      await copyWithEjs(designUi, import_path.default.join(targetDir, "src", "ui"), templateVars);
+    }
+    const designCss = import_path.default.join(designDir, "globals.css");
+    if (await import_fs_extra.default.pathExists(designCss)) {
+      await import_fs_extra.default.copy(designCss, import_path.default.join(targetDir, "src", "app", "globals.css"));
+    }
+    const designApp = import_path.default.join(designDir, "app-overlay");
+    if (await import_fs_extra.default.pathExists(designApp)) {
+      await copyWithEjs(designApp, import_path.default.join(targetDir, "src", "app"), templateVars);
+    }
+  }
   const messagesRoot = findMessagesDir(__dirname);
   const targetMessages = import_path.default.join(targetDir, "messages");
   await import_fs_extra.default.ensureDir(targetMessages);
@@ -479,6 +508,24 @@ async function scaffold(options) {
       import_path.default.join(targetMessages, `${options.language}.json`)
     );
   }
+  if (designName && designDir && !options.canvas) {
+    const patchDir = import_path.default.join(designDir, "messages-patch");
+    if (await import_fs_extra.default.pathExists(patchDir)) {
+      const localeFiles = (await import_fs_extra.default.readdir(targetMessages)).filter((f) => f.endsWith(".json"));
+      for (const file of localeFiles) {
+        const locale = file.replace(/\.json$/, "");
+        let patchFile = import_path.default.join(patchDir, `${locale}.json`);
+        if (!await import_fs_extra.default.pathExists(patchFile)) {
+          patchFile = import_path.default.join(patchDir, "en.json");
+        }
+        if (!await import_fs_extra.default.pathExists(patchFile)) continue;
+        const targetFile = import_path.default.join(targetMessages, file);
+        const base = await import_fs_extra.default.readJson(targetFile);
+        const patch = await import_fs_extra.default.readJson(patchFile);
+        await import_fs_extra.default.writeJson(targetFile, deepMerge(base, patch), { spaces: 2 });
+      }
+    }
+  }
   if (isMultiLocale) {
     const appDir = import_path.default.join(targetDir, "src", "app");
     const localeDir = import_path.default.join(appDir, "[locale]");
@@ -490,7 +537,7 @@ async function scaffold(options) {
       await import_fs_extra.default.move(import_path.default.join(appDir, entry.name), import_path.default.join(localeDir, entry.name));
     }
   }
-  if (await import_fs_extra.default.pathExists(themeDir)) {
+  if (!options.canvas && !designName && await import_fs_extra.default.pathExists(themeDir)) {
     const themeCss = import_path.default.join(themeDir, "globals.css");
     if (await import_fs_extra.default.pathExists(themeCss)) {
       await import_fs_extra.default.copy(themeCss, import_path.default.join(targetDir, "src", "app", "globals.css"));
@@ -501,6 +548,18 @@ async function scaffold(options) {
     }
   }
 }
+function deepMerge(base, patch) {
+  const out = { ...base };
+  for (const [key, value] of Object.entries(patch)) {
+    const existing = out[key];
+    if (value && typeof value === "object" && !Array.isArray(value) && existing && typeof existing === "object" && !Array.isArray(existing)) {
+      out[key] = deepMerge(existing, value);
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
 function findTemplatesDir(fromDir) {
   let dir = fromDir;
   for (let i = 0; i < 5; i++) {
@@ -693,7 +752,11 @@ async function checkForUpdate(name, current) {
           res.on("end", () => {
             try {
               const latest = JSON.parse(data).version;
-              resolve(latest && latest !== current ? latest : null);
+              const newer = latest && latest.split(".").map(Number).reduce((acc, seg, i) => {
+                if (acc !== 0) return acc;
+                return seg - (Number(current.split(".")[i]) || 0);
+              }, 0) > 0;
+              resolve(newer ? latest : null);
             } catch {
               resolve(null);
             }
@@ -714,7 +777,13 @@ var program = new import_commander.Command();
 program.name("create-brainerce-store").description("Scaffold a production-ready e-commerce storefront connected to Brainerce").version(pkg.version).argument("[project-name]", "Name for the project directory").option("--connection-id <id>", "Brainerce vibe-coded connection ID (vc_*)").option(
   "--api-url <url>",
   "Brainerce API base URL (overrides BRAINERCE_API_URL env, defaults to https://api.brainerce.com)"
-).option("--language <lang>", "Store language (en, he)").option("--framework <framework>", "Framework to use", "nextjs").option("--theme <theme>", "Theme to apply", "minimal").option("--pkg-manager <manager>", "Package manager (npm, pnpm, yarn, bun)").option("--no-git", "Skip git initialization").option("--no-install", "Skip dependency installation").action(async (projectNameArg, options) => {
+).option("--language <lang>", "Store language (en, he)").option("--framework <framework>", "Framework to use", "nextjs").option("--theme <theme>", "Token theme to apply (kept for backward compat)", "minimal").option(
+  "--design <design>",
+  "Storefront design pack: passepartout (warm gallery minimal) or minimal (bare base)"
+).option("--pkg-manager <manager>", "Package manager (npm, pnpm, yarn, bun)").option(
+  "--canvas",
+  "Scaffold src/ui as bare unstyled skeletons \u2014 a blank canvas for AI-driven design (commerce stays fully wired)"
+).option("--no-git", "Skip git initialization").option("--no-install", "Skip dependency installation").action(async (projectNameArg, options) => {
   try {
     logger.banner(pkg.version);
     const nodeError = validateNodeVersion(process.versions.node);
@@ -746,6 +815,7 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
     const VALID_PKG_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
     const VALID_FRAMEWORKS = ["nextjs"];
     const VALID_THEMES = ["minimal", "luxury", "playful"];
+    const VALID_DESIGNS = ["minimal", "passepartout"];
     let language = options.language;
     if (language && !VALID_LANGUAGES.includes(language)) {
       logger.error(
@@ -765,6 +835,11 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
       logger.error(`Invalid --theme "${theme}". Expected one of: ${VALID_THEMES.join(", ")}`);
       process.exit(1);
     }
+    let design = options.design;
+    if (design && !VALID_DESIGNS.includes(design)) {
+      logger.error(`Invalid --design "${design}". Expected one of: ${VALID_DESIGNS.join(", ")}`);
+      process.exit(1);
+    }
     let pkgManager = options.pkgManager;
     if (pkgManager && !VALID_PKG_MANAGERS.includes(pkgManager)) {
       logger.error(
@@ -774,6 +849,7 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
     }
     const skipGit = options.git === false;
     const skipInstall = options.install === false;
+    const canvas = options.canvas === true;
     let storeInfo = null;
     let resolvedApiUrl = candidateApiUrls[0];
     if (connectionId) {
@@ -813,13 +889,16 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
         language: languageDefault,
         framework,
         theme,
-        pkgManager
+        design,
+        pkgManager,
+        canvas
       });
       projectName = answers.projectName;
       connectionId = answers.connectionId;
       language = answers.language;
       framework = answers.framework;
       theme = answers.theme;
+      design = answers.design;
       pkgManager = answers.pkgManager;
     }
     const nameError = validateProjectName(projectName);
@@ -871,7 +950,9 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
       currency: storeInfo.currency,
       language: language || storeInfo.language,
       i18n: storeInfo.i18n,
-      scaffoldInPlace
+      scaffoldInPlace,
+      canvas,
+      design: canvas ? void 0 : design || "minimal"
     });
     scaffoldSpinner.succeed(
       scaffoldInPlace ? "Scaffolded into current directory" : `Scaffolded into ./${projectName}`
@@ -911,14 +992,38 @@ program.name("create-brainerce-store").description("Scaffold a production-ready
         );
       }
     }
-    logger.success("\nYour Brainerce store is ready!\n");
-    logger.info("Next steps:");
-    if (!scaffoldInPlace) {
-      logger.step(`cd ${projectName}`);
-    }
-    logger.step(`${pkgManager}${pkgManager === "npm" ? " run" : ""} dev`);
-    logger.info(`
+    if (canvas) {
+      logger.success("\nYour Brainerce store is ready \u2014 as a blank canvas!\n");
+      logger.info(
+        "Commerce is fully wired (cart, checkout, variants, coupons), but src/ui\nis bare, unstyled skeletons with zero aesthetic opinion. THE next step\nis to design it \u2014 open this folder in Claude Code and run:"
+      );
+      logger.step(`/design <your art-direction brief>`);
+      logger.info("\nThen:");
+      if (!scaffoldInPlace) {
+        logger.step(`cd ${projectName}`);
+      }
+      logger.step(`${pkgManager}${pkgManager === "npm" ? " run" : ""} dev`);
+      logger.info(
+        `
+Your store will be running at http://localhost:3000
+(hook contracts + rules: AI-GUIDE.md)`
+      );
+    } else {
+      logger.success("\nYour Brainerce store is ready!\n");
+      logger.info("Next steps:");
+      if (!scaffoldInPlace) {
+        logger.step(`cd ${projectName}`);
+      }
+      logger.step(`${pkgManager}${pkgManager === "npm" ? " run" : ""} dev`);
+      logger.info(`
 Your store will be running at http://localhost:3000`);
+      logger.info(
+        `
+Want a unique design? Open this folder in Claude Code and run:
+  /design <your art-direction brief>
+(commerce stays intact \u2014 see AI-GUIDE.md)`
+      );
+    }
     const latestVersion = await updateCheck;
     if (latestVersion) logger.updateAvailable(latestVersion, pkg.version);
   } catch (err) {

package/messages/en.json

@@ -247,7 +247,9 @@
     "privacyPolicyLink": "Privacy Policy",
     "privacyRequired": "You must accept the privacy policy to continue",
     "acceptsMarketing": "Send me news, promotions, and updates by email",
-    "saveDetailsForNextTime": "Save my details for faster checkout next time"
+    "saveDetailsForNextTime": "Save my details for faster checkout next time",
+    "orderNotes": "Order notes (optional)",
+    "orderNotesPlaceholder": "Anything we should know about your order? e.g. delivery instructions"
   },
   "auth": {
     "loginPageTitle": "Sign In",
@@ -331,6 +333,7 @@
     "orderHistory": "Order History",
     "noOrders": "No orders yet",
     "noOrdersDesc": "Your order history will appear here after your first purchase.",
+    "orderNotes": "Your order note",
     "verified": "Verified",
     "unverified": "Unverified",
     "memberSince": "Member since",

package/messages/he.json

@@ -247,7 +247,9 @@
     "privacyPolicyLink": "מדיניות הפרטיות",
     "privacyRequired": "יש לאשר את מדיניות הפרטיות כדי להמשיך",
     "acceptsMarketing": "שלחו לי חדשות, מבצעים ועדכונים במייל",
-    "saveDetailsForNextTime": "שמרו את הפרטים שלי לתשלום מהיר בפעם הבאה"
+    "saveDetailsForNextTime": "שמרו את הפרטים שלי לתשלום מהיר בפעם הבאה",
+    "orderNotes": "הערות להזמנה (אופציונלי)",
+    "orderNotesPlaceholder": "משהו שכדאי שנדע על ההזמנה? למשל הנחיות למשלוח"
   },
   "auth": {
     "loginPageTitle": "התחברות",
@@ -331,6 +333,7 @@
     "orderHistory": "היסטוריית הזמנות",
     "noOrders": "אין הזמנות עדיין",
     "noOrdersDesc": "היסטוריית ההזמנות שלך תופיע כאן לאחר הרכישה הראשונה.",
+    "orderNotes": "ההערה שלך להזמנה",
     "verified": "מאומת",
     "unverified": "לא מאומת",
     "memberSince": "חבר מאז",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-brainerce-store",
-  "version": "1.50.1",
+  "version": "1.51.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

@@ -0,0 +1,51 @@
+---
+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
+
+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

@@ -17,3 +17,8 @@ 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,3 +1,57 @@
-{
-  "extends": ["next/core-web-vitals"]
-}
+{
+  "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/AGENTS.md

@@ -0,0 +1,41 @@
+# AGENTS.md — this is a Brainerce storefront
+
+This store's commerce engine (cart, checkout, variants, auth, i18n) is
+already wired and working. Your job here is almost always **design**.
+
+## The one rule
+
+**`src/core/` is the platform's. `src/ui/` is yours.**
+
+The shipped `src/ui/` is a working reference, not a design to preserve —
+full delete-and-rebuild of ui files is encouraged and expected.
+Rewrite anything under `src/ui/` and `src/app/globals.css` as boldly as you
+like — the store keeps working. Never modify `src/core/`, `src/app/api/`, or
+the checkout/auth/account components. Data and behavior come exclusively from
+`@/core/hooks/*` and `@/core/providers/store-provider` — hooks return state
+and handlers, never JSX. Never hardcode catalog content.
+
+**Read `AI-GUIDE.md` before any redesign** — it has the full file map, hook
+contracts, and hard-won RTL/i18n gotchas that will save you real debugging
+time.
+
+## Redesigning?
+
+Follow the process documented in AI-GUIDE.md: commit to one art direction,
+rewrite tokens first, then surfaces in order (header, home, card, product
+page, cart), then verify.
+
+## Verify before declaring done
+
+1. `pnpm exec tsc --noEmit` → 0 errors
+2. `pnpm dev` → drive the changed flow in a real browser (home → product →
+   add to cart → cart)
+3. Screenshot desktop (1440px) and mobile (390px)
+4. RTL stores: check anchoring and arrow directions
+
+## i18n
+
+Every user-facing string goes through `useTranslations()` with keys in **all**
+files under `messages/`. Hebrew: no uppercase transforms, no wide
+letter-spacing on headings, logical CSS properties only (`ms-/me-`, `ps-/pe-`,
+`start-/end-`).