@spree/cli 3.2.2 → 3.4.0

package/dist/templates/dashboard-starter/AGENTS.md

@@ -1,11 +1,20 @@
 # Agent Instructions
 
+`CLAUDE.md` only imports this file — edit this one.
+
 This is the Spree admin dashboard for this project — a Vite + React app. The
 shell (routes, chrome, resource pages) ships in `@spree/dashboard`; this
 project holds your customizations.
 
 Full docs: https://spreecommerce.org/docs/developer/dashboard/overview
 
+## Running it
+
+`spree dev`, run from the project root (`../..`), starts this app's dev server
+together with the Spree API — don't start a second copy with `pnpm dev`. The
+Spree API itself is only ever run through the Spree CLI; see the project
+root's `AGENTS.md`.
+
 ## Imports
 
 Import from `@spree/dashboard` — it re-exports the framework and the design
@@ -44,8 +53,10 @@ of what exists, not an implementation.
 - **Wrap API calls in a hook.** Components never call `adminClient` directly.
 - **Query keys are store-scoped.** Build them with `useResourceKey`; a bare
   `['brands']` key leaks one store's data into another after a store switch.
-- **Writes go through `useResourceMutation`**, which maps 422 responses onto
-  form fields instead of firing a toast.
+- **Writes go through `useResourceMutation`.** It shows a toast for network
+  and server failures but not for 422 validation errors — catch those in the
+  form's submit handler with `mapSpreeErrorsToForm`, which puts each message on
+  its field.
 - **Every visible string goes through i18next** — page titles, column labels,
   buttons, empty states, toasts. Never hardcode English in JSX or in a table
   definition. Add each new key to every locale file the project ships.
@@ -55,12 +66,15 @@ of what exists, not an implementation.
   walks every nested key and the SDK's object graph overflows the TypeScript
   compiler.
 - **A sortable or filterable column must be allowlisted for Ransack** on the
-  model, or the request fails at runtime.
+  model, or the request fails at runtime. That change belongs to the Spree API
+  in `../../server/` — follow `../../server/AGENTS.md`.
 - **Destructive actions that fire straight from a click need a confirm** —
   `useConfirm()` with `variant: 'destructive'`.
 
 ## Checks
 
+Run these with the project's package manager (`pnpm`, `npm run` or `yarn`):
+
 ```bash
 pnpm typecheck
 pnpm lint

package/dist/templates/dashboard-starter/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/dist/templates/dashboard-starter/package.json

@@ -16,24 +16,27 @@
     "lint:fix": "biome check --fix ."
   },
   "dependencies": {
-    "@spree/admin-sdk": "^1.0.0-rc.1",
-    "@spree/dashboard": "^1.0.0-rc.2",
-    "@spree/dashboard-core": "^1.0.0-rc.2",
-    "@spree/dashboard-ui": "^1.0.0-rc.2",
-    "@tanstack/react-query": "^5.100.9",
-    "@tanstack/react-router": "^1.169.2",
-    "react": "^19.2.6",
-    "react-dom": "^19.2.6"
+    "@spree/admin-sdk": "^1.0.0-rc.4",
+    "@spree/dashboard": "^1.0.0-rc.4",
+    "@spree/dashboard-core": "^1.0.0-rc.4",
+    "@spree/dashboard-ui": "^1.0.0-rc.4",
+    "@tanstack/react-query": "^5.104.3",
+    "@tanstack/react-router": "^1.170.44",
+    "i18next": "^26.4.7",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "react-hook-form": "^7.90.0",
+    "react-i18next": "^17.0.20"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
-    "@playwright/test": "^1.59.1",
+    "@playwright/test": "^1.64.1",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
-    "typescript": "~6.0.3",
-    "vite": "^8.0.16",
-    "vitest": "^4.1.5"
+    "typescript": "~7.0.2",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.5"
   },
   "packageManager": "pnpm@11.13.1"
 }