@base44/app-plugin-commerce 0.9.4 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44/app-plugin-commerce",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Base44 Commerce plugin — entities, backend functions, shared commerce engine, admin UI and the commerce skill, shipped as copyable source",
   "keywords": [
     "base44",

package/skills/commerce/installation/install.md

@@ -47,22 +47,27 @@ lines and treat that stage as done — but keep reading this file, not re-fetchi
 
 **Dependencies.** `sonner`, `recharts`, `react-markdown` — all three ship with the default Base44 template, so check `package.json` and `npm i` only what is actually absent (the normal outcome is installing nothing).
 
-## The whole build is THREE messages from here
-
-Image generation is the slowest step and nothing depends on it until seed time; the storefront doesn't wait on live data either. So batch hard: every extra assistant message restarts your reasoning and buys another sandbox validate — on real builds, fragmenting this plan roughly doubles LLM time while producing the same files.
-
-- **M1 — kick off + foundation.** Every `generate_image` call (all products, one message), and in the same message: fonts/meta in `index.html`, the complete design system in `src/index.css` (written ONCE — later tweaks are `find_replace`, never a rewrite), `base44/ui.jsonc`, and the admin mount + routes in `src/App.jsx` (below).
-  ⚑ **The result already carries the real `image_url`** alongside a `placeholder_url`
-  — use `image_url` and move on. Nothing is pending, there is nothing to poll, and a
-  backend function calling `Core.GenerateImage` to "fetch the real URLs" is pure waste:
-  you already have them. If a `/__generating__/…` value does reach a file or a seed
-  payload, the platform swaps it for the real URL after the turn (in files *and* entity
-  records) — so a placeholder that renders broken in a mid-build preview is expected and
-  must not be "fixed".
-- **M2 — the whole storefront + the seed, one message.** Every component and page, written from the shapes in [stage 02 below](#02--storefront) — not from live data — with the `commerce/seed-store` call ([stage 03 below](#03--store-data)) in the SAME message: M1's image URLs are already real. Never write pages one or two at a time.
-- **M3 — converge.** Fix only what a tool result reported broken, run the checklists by recall, hand over. Payments last, if at all — cards are off by default; [stage 03 below](#03--store-data) decides it.
-
-Custom scope beyond the kit (an extra entity, a backend function) rides M1/M2 — it buys no extra messages. The only dependency edges are *image URLs → seed payload* and *seed done → real products on the pages*.
+## Work order — interleave, don't queue
+
+Image generation is the slowest step and nothing depends on it until seed time; the storefront doesn't wait on live data either.
+
+1. **Start image generation first** — every product image, before anything else.
+   ⚑ **The result already carries the real `image_url`** alongside a `placeholder_url`
+   — use `image_url` and move on. Nothing is pending, there is nothing to poll, and a
+   backend function calling `Core.GenerateImage` to "fetch the real URLs" is pure waste:
+   you already have them. If a `/__generating__/…` value does reach a file or a seed
+   payload, the platform swaps it for the real URL after the turn (in files *and* entity
+   records) — so a placeholder that renders broken in a mid-build preview is expected and
+   must not be "fixed".
+2. **Mount the admin (below) and build the storefront** while images render. Every
+   request and response shape the pages build against is written out in
+   [stage 02 below](#02--storefront), so they are written from the docs,
+   not from live data.
+3. **Seed the moment the image URLs are back** — one `commerce/seed-store` call ([stage 03 below](#03--store-data)). Its writes run in parallel, so the call usually takes a few seconds — but don't idle on it either.
+4. **Converge**: open the finished pages against the live catalog.
+5. **Payments last, if at all** — cards are off by default; [stage 03 below](#03--store-data) decides it.
+
+The only dependency edges are *image URLs → seed payload* and *seed done → real products on the pages*.
 
 ## Pre-verified — take this file on faith