@vibes.diy/prompts 14.3.204 → 14.3.205

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,16 +1,20 @@
1
1
  # Storefront
2
2
 
3
- A small shop: product cards to browse, a category filter and a search, a bag that adds things up, and a checkout that places the order. It fits a potter's ceramics, a bakery's preorders, a club's merch table or a school fair's stall. Reach for it whenever the app's core is a short catalogue that people pick from and then order. The catalogue stays inline in the code, and the bag lives in the page while someone shops. Each placed order persists as its own document, so the shop can see what to make and the buyer can see what they ordered. It records orders only; taking payment is a separate integration this block does not pretend to do.
3
+ A small shop: product cards to browse, a category filter and a search, a bag that adds things up, and a checkout that places the order. It fits a potter's ceramics, a bakery's preorders, a club's merch table or a school fair's stall. Reach for it whenever the app's core is a short catalogue that people pick from and then order. The catalogue is the owner's: each thing for sale is a `product` record the owner adds on the app's own Products screen, with its name, price, a short line, a category and a photo, so changing what the shop sells is an edit in the app, never a rebuild. The bag lives in the page while someone shops. Each placed order persists as its own document, so the shop can see what to make and the buyer can see what they ordered. It records orders; taking card payment is the `stripe` skill, which reads these same product records.
4
4
 
5
5
  Built from @vibes.diy/ui components; persisted state lives in Fireproof. Every write surface is gated on `useVibe(dbName).can`.
6
6
 
7
7
  ## The block
8
8
 
9
- One view with one job: fill the bag and place the order. A `Navbar` carries the brand and a quiet bag button with a live count, and the `Heading` puts an `orange` `Highlight` on one word beside a muted line. A `Segmented` category filter (`tone="info"`) and a search `Input` in a `Field` sit above a `Grid cols="sidebar"`: on the main side a two-column grid of product `Card`s, each with a decorative `orange` `IconTile`, an `info` `Badge` for "New" or "Bestseller", the price in numeric `Text` and a quiet `Add to bag` (an `Empty` stands in when nothing matches); on the side the bag's `Card`, one line per product with its total and `IconButton`s to take one away or add one, then the subtotal, shipping and total. `Place order` is the view's one lead; it shows `loading` while the write lands, and the bag empties only after it does. An order is one document holding a snapshot of each line's name, price and quantity, the totals and the buyer's handle, so a later price change never rewrites an order already placed; the person's own orders list under the bag, each with a `Badge` for its status (`info` received, `warn` ready to collect, `up` collected). Checkout waits on its `can` verdict from `useVibe("shop")`: a `Skeleton` inside an `aria-busy` wrapper while it resolves, a sentence in the app's own words when ordering is closed, and for a visitor who has not signed in a `Sign in to place your order` lead wired to `useViewer().requestLogin()`, with the bag they filled kept in place. Sign-in is required here, unlike a local-first note, because a signed-out write stays on the device until sign-in: an order placed that way would never reach the shop.
9
+ Two screens, one job each. The **Shop** fills the bag and places the order: a `Navbar` carries the brand and a quiet bag button with a live count, and the `Heading` puts an `orange` `Highlight` on one word beside a muted line. A `Segmented` category filter (`tone="info"`) and a search `Input` in a `Field` sit above a `Grid cols="sidebar"`: on the main side a two-column grid of product `Card`s, each fronted by its photo in a `Figure` (or the category's decorative `orange` `IconTile` until a photo is added), an `info` `Badge` for "New" or "Bestseller", the price in numeric `Text` and a quiet `Add to bag` (an `Empty` stands in when nothing matches); on the side the bag's `Card`, one line per product with its total and `IconButton`s to take one away or add one, then the subtotal, shipping and total. `Place order` is the shop's one lead; it shows `loading` while the write lands, and the bag empties only after it does.
10
+
11
+ The **Products** screen is the owner's, behind `can.create` on a product draft: a form for the name, price, short line, category and photo, then one row per product whose price edits in place and whose `On sale` checkbox puts it in front of buyers or takes it away. The catalogue starts empty, and an owner who opens an empty shop lands on this screen with "Add the first thing you sell"; a visitor sees a warm `Empty` until the first product goes on sale. Every price is a whole number in the currency's smallest unit (cents for usd, whole yen for jpy) beside its `currency`, the unit card payments charge in, and the page shows, edits and adds prices through that unit.
12
+
13
+ An order is one document holding a snapshot of each line's title, unit price and quantity, the totals, the currency and the buyer's handle, so a later price change never rewrites an order already placed; the person's own orders list under the bag, each with a `Badge` for its status (`info` received, `warn` ready to collect, `up` collected). Checkout waits on its `can` verdict from `useVibe("orders")`: a `Skeleton` inside an `aria-busy` wrapper while it resolves, a sentence in the app's own words when ordering is closed, and for a visitor who has not signed in a `Sign in to place your order` lead wired to `useViewer().requestLogin()`, with the bag they filled kept in place. Sign-in is required here, unlike a local-first note, because a signed-out write stays on the device until sign-in: an order placed that way would never reach the shop.
10
14
 
11
15
  ### `App.jsx`
12
16
  ```jsx
13
- import React, { useState } from "react";
17
+ import React, { useEffect, useState } from "react";
14
18
  import { useFireproof } from "use-fireproof";
15
19
  import { useViewer, useVibe } from "use-vibes";
16
20
  import {
@@ -21,6 +25,7 @@ import {
21
25
  Empty,
22
26
  Eyebrow,
23
27
  Field,
28
+ Figure,
24
29
  Grid,
25
30
  Heading,
26
31
  Highlight,
@@ -35,51 +40,191 @@ import {
35
40
  Stack,
36
41
  Text,
37
42
  } from "@vibes.diy/ui";
38
- import { Separator, Toaster, toast } from "@vibes.diy/ui/interactive";
43
+ import { Checkbox, Select, Separator, Toaster, toast } from "@vibes.diy/ui/interactive";
44
+
45
+ // Prices are whole numbers in the currency's smallest unit: cents for usd, whole yen for jpy.
46
+ // Show, edit and add them through that unit, never a fixed 100.
47
+ const CURRENCY = "usd"; // the currency new products are priced in
48
+ const digits = (currency) => new Intl.NumberFormat("en", { style: "currency", currency }).resolvedOptions().maximumFractionDigits;
49
+ const money = (amount, currency) => new Intl.NumberFormat(undefined, { style: "currency", currency }).format(amount / 10 ** digits(currency));
50
+ const toMinor = (text, currency) => Math.round(Number(text) * 10 ** digits(currency));
51
+ const shown = (amount, currency) => (amount / 10 ** digits(currency)).toFixed(digits(currency));
39
52
 
40
- const PRODUCTS = [
41
- { id: "mug", name: "Speckled mug", blurb: "Holds a generous coffee, glazed oatmeal.", price: 28, category: "table", icon: "drop", badge: "Bestseller" },
42
- { id: "bowl", name: "Nesting bowls", blurb: "A set of three for salads and snacks.", price: 64, category: "table", icon: "home" },
43
- { id: "vase", name: "Bud vase", blurb: "A small home for a few stems.", price: 36, category: "home", icon: "sparkle", badge: "New" },
44
- { id: "planter", name: "Hanging planter", blurb: "Thrown stoneware with a jute cord.", price: 48, category: "home", icon: "sun" },
45
- { id: "dish", name: "Ring dish", blurb: "A shallow dish for keys and rings.", price: 18, category: "gifts", icon: "heart" },
46
- { id: "card", name: "Gift card", blurb: "Let them pick their own favourite.", price: 50, category: "gifts", icon: "tag" },
47
- ];
48
53
  const CATEGORIES = [
49
- { value: "all", label: "All" },
50
- { value: "table", label: "Table" },
51
- { value: "home", label: "Home" },
52
- { value: "gifts", label: "Gifts" },
54
+ { value: "table", label: "Table", icon: "drop" },
55
+ { value: "home", label: "Home", icon: "home" },
56
+ { value: "gifts", label: "Gifts", icon: "heart" },
53
57
  ];
54
- const MONEY = new Intl.NumberFormat(undefined, { style: "currency", currency: "USD" });
55
- const FREE_SHIPPING = 100;
58
+ const FILTERS = [{ value: "all", label: "All" }, ...CATEGORIES.map(({ value, label }) => ({ value, label }))];
59
+ const BADGES = [
60
+ { value: "", label: "No badge" },
61
+ { value: "New", label: "New" },
62
+ { value: "Bestseller", label: "Bestseller" },
63
+ ];
64
+ const PRODUCT_DRAFT = { _id: "product-draft", type: "product", title: "Draft", amount: 100, currency: CURRENCY, onSale: true };
65
+ const iconOf = (category) => CATEGORIES.find((c) => c.value === category)?.icon ?? "tag";
66
+ // Shipping in the same smallest unit: a flat rate, free over a threshold.
67
+ const SHIPPING = 800;
68
+ const FREE_SHIPPING = 10000;
56
69
  const ORDER_STATUS = {
57
70
  received: { label: "Received", tone: "info" },
58
71
  ready: { label: "Ready to collect", tone: "warn" },
59
72
  collected: { label: "Collected", tone: "up" },
60
73
  };
74
+ const MAX_QTY = 99; // the most of one thing a bag holds
61
75
  const plural = (n, one, many) => (n === 1 ? `1 ${one}` : `${n} ${many}`);
62
76
 
77
+ // One product on the owner's list: its price edits in place, and On sale puts it in front of
78
+ // buyers or takes it away. A refused write puts the shown price back.
79
+ function ProductRow({ product, save }) {
80
+ const [price, setPrice] = useState(shown(product.amount, product.currency));
81
+ useEffect(() => setPrice(shown(product.amount, product.currency)), [product.amount]);
82
+ const commit = () => {
83
+ const amount = toMinor(price, product.currency);
84
+ if (Number.isInteger(amount) && amount > 0 && amount !== product.amount) save({ ...product, amount }, () => setPrice(shown(product.amount, product.currency)));
85
+ else setPrice(shown(product.amount, product.currency));
86
+ };
87
+ return (
88
+ <Row gap={3} wrap={false}>
89
+ {product._files?.photo?.url ? (
90
+ <Figure src={product._files.photo.url} alt={product.title} width={48} height={48} />
91
+ ) : (
92
+ <IconTile icon={iconOf(product.category)} tone="orange" size="sm" />
93
+ )}
94
+ <Text truncate>{product.title}</Text>
95
+ <Spacer />
96
+ <Field label="Price">
97
+ {(id, describedBy) => (
98
+ <Input id={id} describedBy={describedBy} value={price} onChange={setPrice} onBlur={commit} onKeyDown={(e) => e.key === "Enter" && commit()} inputMode="decimal" />
99
+ )}
100
+ </Field>
101
+ <Checkbox label="On sale" checked={product.onSale} onChange={(on) => save({ ...product, onSale: on === true })} />
102
+ </Row>
103
+ );
104
+ }
105
+
106
+ // The owner's catalogue: what is for sale and what it costs. Each save is a `product` record that
107
+ // access.js takes from the owner alone. Empty, the form for the first product leads.
108
+ function Products({ products, onAdd }) {
109
+ const { database } = useFireproof("orders");
110
+ const blank = { title: "", price: "", blurb: "", category: CATEGORIES[0].value, badge: "", photo: null };
111
+ const [draft, setDraft] = useState(blank);
112
+ const [adding, setAdding] = useState(false);
113
+ const [error, setError] = useState(null);
114
+ // A file input keeps its pick until it remounts, so each new draft gets a fresh one.
115
+ const [pickerKey, setPickerKey] = useState(0);
116
+ const edit = (key, value) => setDraft((d) => ({ ...d, [key]: value }));
117
+
118
+ // A plain put lands on this device at once and the server's verdict arrives on its receipt; a
119
+ // put carrying a photo uploads first and rejects instead. Either way the owner hears why.
120
+ async function save(product, undo) {
121
+ setError(null);
122
+ try {
123
+ const { synced } = await database.put(product);
124
+ synced.on((s) => {
125
+ if (s.status !== "refused") return;
126
+ undo?.();
127
+ setError(s.message ?? "That did not save: a product needs a name and a price like 12.50.");
128
+ });
129
+ } catch (err) {
130
+ undo?.();
131
+ setError(err.message);
132
+ }
133
+ }
134
+
135
+ async function add() {
136
+ const amount = toMinor(draft.price, CURRENCY);
137
+ if (!draft.title.trim() || !Number.isInteger(amount) || amount <= 0) return setError("Give it a name and a price like 12.50.");
138
+ const product = {
139
+ _id: "product-" + crypto.randomUUID(),
140
+ type: "product",
141
+ title: draft.title.trim(),
142
+ blurb: draft.blurb.trim(),
143
+ category: draft.category,
144
+ badge: draft.badge || null,
145
+ amount,
146
+ currency: CURRENCY,
147
+ onSale: true,
148
+ createdAt: Date.now(),
149
+ _files: draft.photo ? { photo: draft.photo } : {},
150
+ };
151
+ // The owner stays here: the first product would otherwise flip an empty shop's default screen.
152
+ onAdd();
153
+ setAdding(true);
154
+ const cleared = { ...blank };
155
+ setDraft(cleared);
156
+ setPickerKey((k) => k + 1);
157
+ // A refused write hands the draft back, unless the owner has touched the next one.
158
+ await save(product, () => setDraft((d) => (d === cleared ? draft : d)));
159
+ setAdding(false);
160
+ }
161
+
162
+ return (
163
+ <Stack gap={5}>
164
+ <Card>
165
+ <Stack gap={4}>
166
+ <Heading level={2}>{products.length === 0 ? "Add the first thing you sell" : "Add a product"}</Heading>
167
+ <Grid cols={2} gap={3}>
168
+ <Field label="Name">{(id, describedBy) => <Input id={id} describedBy={describedBy} value={draft.title} onChange={(v) => edit("title", v)} placeholder="Speckled mug" />}</Field>
169
+ <Field label="Price">{(id, describedBy) => <Input id={id} describedBy={describedBy} value={draft.price} onChange={(v) => edit("price", v)} placeholder="28.00" inputMode="decimal" />}</Field>
170
+ <Field label="Short line">{(id, describedBy) => <Input id={id} describedBy={describedBy} value={draft.blurb} onChange={(v) => edit("blurb", v)} placeholder="Holds a generous coffee." />}</Field>
171
+ <Field label="Category">{(id, describedBy) => <Select id={id} describedBy={describedBy} value={draft.category} onChange={(v) => edit("category", v)} options={CATEGORIES} />}</Field>
172
+ <Field label="Badge">{(id, describedBy) => <Select id={id} describedBy={describedBy} value={draft.badge} onChange={(v) => edit("badge", v)} options={BADGES} />}</Field>
173
+ <Field label="Photo">{(id, describedBy) => <input key={pickerKey} id={id} aria-describedby={describedBy} type="file" accept="image/*" onChange={(e) => edit("photo", e.target.files?.[0] ?? null)} />}</Field>
174
+ </Grid>
175
+ {error && <Text>{error}</Text>}
176
+ <Button loading={adding} onClick={add}>
177
+ Add to the shop
178
+ </Button>
179
+ </Stack>
180
+ </Card>
181
+ {products.length > 0 && (
182
+ <Card>
183
+ <Stack gap={3}>
184
+ <Heading level={2}>Products</Heading>
185
+ {products.map((p) => (
186
+ <ProductRow key={p._id} product={p} save={save} />
187
+ ))}
188
+ </Stack>
189
+ </Card>
190
+ )}
191
+ </Stack>
192
+ );
193
+ }
194
+
63
195
  export default function App() {
64
- const { database, useLiveQuery } = useFireproof("shop");
196
+ const { database, useLiveQuery } = useFireproof("orders");
65
197
  const { docs: orders } = useLiveQuery("type", { key: "order" });
66
- const { can, me } = useVibe("shop");
198
+ const { docs: products } = useLiveQuery("type", { key: "product" });
199
+ const { can, me } = useVibe("orders");
67
200
  const { requestLogin } = useViewer();
68
201
 
202
+ // The owner's verdict on a product draft carrying every field add() stamps: access.js takes
203
+ // product records from the owner alone, and only with a name, a whole-unit price and a currency.
204
+ const canStock = can.create(PRODUCT_DRAFT);
205
+ // An owner with an empty shop starts on Products; after that the shop leads until they switch.
206
+ const [view, setView] = useState(null);
207
+ const screen = view ?? (!canStock.pending && canStock.ok && products.length === 0 ? "products" : "shop");
208
+
69
209
  const [category, setCategory] = useState("all");
70
210
  const [query, setQuery] = useState("");
71
211
  // The bag is a draft: it lives in the page until the order is placed.
72
212
  const [bag, setBag] = useState({});
73
213
  const [placing, setPlacing] = useState(false);
74
214
 
215
+ // One currency per bag: the shop sells in CURRENCY, so a record priced in another stays off the shelf.
216
+ const forSale = products.filter((p) => p.onSale && p.currency === CURRENCY).sort((a, b) => a.createdAt - b.createdAt);
75
217
  const needle = query.trim().toLowerCase();
76
- const visible = PRODUCTS.filter(
77
- (p) => (category === "all" || p.category === category) && (needle === "" || `${p.name} ${p.blurb}`.toLowerCase().includes(needle))
218
+ const visible = forSale.filter(
219
+ (p) => (category === "all" || p.category === category) && (needle === "" || `${p.title} ${p.blurb ?? ""}`.toLowerCase().includes(needle))
78
220
  );
79
- const lines = PRODUCTS.filter((p) => (bag[p.id] ?? 0) > 0).map((p) => ({ productId: p.id, name: p.name, price: p.price, qty: bag[p.id] }));
221
+ // A product taken off sale drops out of the bag's lines as well as the grid.
222
+ const lines = forSale
223
+ .filter((p) => (bag[p._id] ?? 0) > 0)
224
+ .map((p) => ({ productId: p._id, title: p.title, unitAmount: p.amount, qty: bag[p._id] }));
80
225
  const count = lines.reduce((n, l) => n + l.qty, 0);
81
- const subtotal = lines.reduce((n, l) => n + l.price * l.qty, 0);
82
- const shipping = subtotal === 0 || subtotal >= FREE_SHIPPING ? 0 : 8;
226
+ const subtotal = lines.reduce((n, l) => n + l.unitAmount * l.qty, 0);
227
+ const shipping = subtotal === 0 || subtotal >= FREE_SHIPPING ? 0 : SHIPPING;
83
228
  const mine = me ? orders.filter((o) => o.authorHandle === me.userHandle).sort((a, b) => b.createdAt - a.createdAt) : [];
84
229
 
85
230
  // The verdict for the order placeOrder writes, carrying the same fields it stamps.
@@ -88,7 +233,7 @@ export default function App() {
88
233
 
89
234
  function change(id, delta) {
90
235
  setBag((b) => {
91
- const qty = Math.max(0, (b[id] ?? 0) + delta);
236
+ const qty = Math.min(MAX_QTY, Math.max(0, (b[id] ?? 0) + delta));
92
237
  const { [id]: _gone, ...rest } = b;
93
238
  return qty === 0 ? rest : { ...rest, [id]: qty };
94
239
  });
@@ -97,7 +242,7 @@ export default function App() {
97
242
  async function placeOrder() {
98
243
  setPlacing(true);
99
244
  try {
100
- await database.put({ ...orderDraft, lines, subtotal, shipping, total: subtotal + shipping, createdAt: Date.now() });
245
+ await database.put({ ...orderDraft, lines, currency: CURRENCY, subtotal, shipping, total: subtotal + shipping, createdAt: Date.now() });
101
246
  // Emptied only once the order lands, so a local failure keeps the bag.
102
247
  setBag({});
103
248
  toast.success("Order placed. We'll be in touch about collection.");
@@ -138,141 +283,170 @@ export default function App() {
138
283
  </Row>
139
284
  }
140
285
  actions={
141
- <Button size="sm" variant="quiet" onClick={() => document.getElementById("bag")?.scrollIntoView({ block: "nearest" })}>
142
- <Icon name="cart" size="sm" />
143
- Bag ({count})
144
- </Button>
286
+ <>
287
+ {!canStock.pending && canStock.ok && (
288
+ <Button size="sm" variant="quiet" onClick={() => setView(screen === "products" ? "shop" : "products")}>
289
+ <Icon name={screen === "products" ? "cart" : "tag"} size="sm" />
290
+ {screen === "products" ? "Shop" : "Products"}
291
+ </Button>
292
+ )}
293
+ {screen === "shop" && (
294
+ <Button size="sm" variant="quiet" onClick={() => document.getElementById("bag")?.scrollIntoView({ block: "nearest" })}>
295
+ <Icon name="cart" size="sm" />
296
+ Bag ({count})
297
+ </Button>
298
+ )}
299
+ </>
145
300
  }
146
301
  />
147
302
 
148
- <Stack gap={2}>
149
- <Eyebrow>Handmade in small batches</Eyebrow>
150
- <Heading level={1}>
151
- Pots for <Highlight tone="orange">everyday</Highlight> things.
152
- </Heading>
153
- <Text muted>Free shipping over {MONEY.format(FREE_SHIPPING)}. Every piece is thrown and glazed by hand.</Text>
154
- </Stack>
155
-
156
- <Row justify="between" align="top">
157
- <Segmented label="Category" tone="info" value={category} onChange={setCategory} options={CATEGORIES} />
158
- <Field label="Search the shop">
159
- {(id, describedBy) => <Input id={id} describedBy={describedBy} value={query} onChange={setQuery} inputMode="search" placeholder="Mug, vase…" />}
160
- </Field>
161
- </Row>
303
+ {screen === "products" ? (
304
+ <Products products={products} onAdd={() => setView("products")} />
305
+ ) : (
306
+ <>
307
+ <Stack gap={2}>
308
+ <Eyebrow>Handmade in small batches</Eyebrow>
309
+ <Heading level={1}>
310
+ Pots for <Highlight tone="orange">everyday</Highlight> things.
311
+ </Heading>
312
+ <Text muted>Free shipping over {money(FREE_SHIPPING, CURRENCY)}. Every piece is thrown and glazed by hand.</Text>
313
+ </Stack>
162
314
 
163
- <Grid cols="sidebar" gap={5}>
164
- {visible.length === 0 ? (
165
- <Empty icon="search" title="Nothing matches">
166
- Try another word or a different category.
167
- </Empty>
168
- ) : (
169
- <Grid cols={2} gap={4}>
170
- {visible.map((p) => (
171
- <Card key={p.id}>
172
- <Stack gap={3}>
173
- <Row justify="between" align="top">
174
- <IconTile icon={p.icon} tone="orange" />
175
- {p.badge && <Badge tone="info">{p.badge}</Badge>}
176
- </Row>
177
- <Stack gap={1}>
178
- <Heading level={3}>{p.name}</Heading>
179
- <Text size="sm" muted>
180
- {p.blurb}
181
- </Text>
182
- </Stack>
183
- <Row justify="between">
184
- <Text num>{MONEY.format(p.price)}</Text>
185
- <Button size="sm" variant="quiet" onClick={() => change(p.id, 1)}>
186
- Add to bag
187
- </Button>
188
- </Row>
189
- </Stack>
190
- </Card>
191
- ))}
192
- </Grid>
193
- )}
315
+ <Row justify="between" align="top">
316
+ <Segmented label="Category" tone="info" value={category} onChange={setCategory} options={FILTERS} />
317
+ <Field label="Search the shop">
318
+ {(id, describedBy) => <Input id={id} describedBy={describedBy} value={query} onChange={setQuery} inputMode="search" placeholder="Mug, vase…" />}
319
+ </Field>
320
+ </Row>
194
321
 
195
- <div id="bag">
196
- <Stack gap={4}>
197
- <Card>
198
- <Stack gap={4}>
199
- <Row justify="between">
200
- <Heading level={2}>Your bag</Heading>
201
- <Text size="sm" muted>
202
- {plural(count, "item", "items")}
203
- </Text>
204
- </Row>
205
- {lines.length === 0 ? (
206
- <Empty icon="cart" title="Your bag is empty">
207
- Add something you love and it waits here.
208
- </Empty>
209
- ) : (
210
- <Stack gap={3}>
211
- {lines.map((l) => (
212
- <Row key={l.productId} gap={2} wrap={false}>
213
- <Stack gap={1}>
214
- <Text truncate>{l.name}</Text>
215
- <Text size="sm" muted num>
216
- {MONEY.format(l.price * l.qty)}
322
+ <Grid cols="sidebar" gap={5}>
323
+ {forSale.length === 0 ? (
324
+ <Empty icon="sparkle" title="New pieces are on their way">
325
+ The shop opens with its first products. Check back soon.
326
+ </Empty>
327
+ ) : visible.length === 0 ? (
328
+ <Empty icon="search" title="Nothing matches">
329
+ Try another word or a different category.
330
+ </Empty>
331
+ ) : (
332
+ <Grid cols={2} gap={4}>
333
+ {visible.map((p) => (
334
+ <Card key={p._id}>
335
+ <Stack gap={3}>
336
+ {p._files?.photo?.url ? (
337
+ <Figure src={p._files.photo.url} alt={p.title} width={400} height={300} />
338
+ ) : (
339
+ <Row justify="between" align="top">
340
+ <IconTile icon={iconOf(p.category)} tone="orange" />
341
+ {p.badge && <Badge tone="info">{p.badge}</Badge>}
342
+ </Row>
343
+ )}
344
+ <Stack gap={1}>
345
+ <Row justify="between" align="top">
346
+ <Heading level={3}>{p.title}</Heading>
347
+ {p._files?.photo?.url && p.badge && <Badge tone="info">{p.badge}</Badge>}
348
+ </Row>
349
+ {p.blurb && (
350
+ <Text size="sm" muted>
351
+ {p.blurb}
217
352
  </Text>
218
- </Stack>
219
- <Spacer />
220
- <IconButton size="sm" variant="quiet" icon={<Icon name="remove" size="sm" />} label={`One fewer ${l.name}`} onClick={() => change(l.productId, -1)} />
221
- <Text num>{l.qty}</Text>
222
- <IconButton size="sm" variant="quiet" icon={<Icon name="add" size="sm" />} label={`One more ${l.name}`} onClick={() => change(l.productId, 1)} />
353
+ )}
354
+ </Stack>
355
+ <Row justify="between">
356
+ <Text num>{money(p.amount, p.currency)}</Text>
357
+ <Button size="sm" variant="quiet" onClick={() => change(p._id, 1)}>
358
+ Add to bag
359
+ </Button>
223
360
  </Row>
224
- ))}
225
- <Separator />
226
- <Row justify="between">
227
- <Text size="sm" muted>
228
- Subtotal
229
- </Text>
230
- <Text size="sm" num>
231
- {MONEY.format(subtotal)}
232
- </Text>
233
- </Row>
361
+ </Stack>
362
+ </Card>
363
+ ))}
364
+ </Grid>
365
+ )}
366
+
367
+ <div id="bag">
368
+ <Stack gap={4}>
369
+ <Card>
370
+ <Stack gap={4}>
234
371
  <Row justify="between">
372
+ <Heading level={2}>Your bag</Heading>
235
373
  <Text size="sm" muted>
236
- Shipping
374
+ {plural(count, "item", "items")}
237
375
  </Text>
238
- <Text size="sm" num>
239
- {shipping === 0 ? "Free" : MONEY.format(shipping)}
240
- </Text>
241
- </Row>
242
- <Row justify="between">
243
- <Text>Total</Text>
244
- <Text num>{MONEY.format(subtotal + shipping)}</Text>
245
376
  </Row>
377
+ {lines.length === 0 ? (
378
+ <Empty icon="cart" title="Your bag is empty">
379
+ Add something you love and it waits here.
380
+ </Empty>
381
+ ) : (
382
+ <Stack gap={3}>
383
+ {lines.map((l) => (
384
+ <Row key={l.productId} gap={2} wrap={false}>
385
+ <Stack gap={1}>
386
+ <Text truncate>{l.title}</Text>
387
+ <Text size="sm" muted num>
388
+ {money(l.unitAmount * l.qty, CURRENCY)}
389
+ </Text>
390
+ </Stack>
391
+ <Spacer />
392
+ <IconButton size="sm" variant="quiet" icon={<Icon name="remove" size="sm" />} label={`One fewer ${l.title}`} onClick={() => change(l.productId, -1)} />
393
+ <Text num>{l.qty}</Text>
394
+ <IconButton size="sm" variant="quiet" icon={<Icon name="add" size="sm" />} label={`One more ${l.title}`} onClick={() => change(l.productId, 1)} />
395
+ </Row>
396
+ ))}
397
+ <Separator />
398
+ <Row justify="between">
399
+ <Text size="sm" muted>
400
+ Subtotal
401
+ </Text>
402
+ <Text size="sm" num>
403
+ {money(subtotal, CURRENCY)}
404
+ </Text>
405
+ </Row>
406
+ <Row justify="between">
407
+ <Text size="sm" muted>
408
+ Shipping
409
+ </Text>
410
+ <Text size="sm" num>
411
+ {shipping === 0 ? "Free" : money(shipping, CURRENCY)}
412
+ </Text>
413
+ </Row>
414
+ <Row justify="between">
415
+ <Text>Total</Text>
416
+ <Text num>{money(subtotal + shipping, CURRENCY)}</Text>
417
+ </Row>
418
+ </Stack>
419
+ )}
420
+ {checkout}
421
+ <Text size="sm" muted>
422
+ We confirm your order and you pay when you collect.
423
+ </Text>
246
424
  </Stack>
425
+ </Card>
426
+
427
+ {mine.length > 0 && (
428
+ <Card variant="tight">
429
+ <Stack gap={3}>
430
+ <Heading level={3}>Your orders</Heading>
431
+ {mine.map((o) => (
432
+ <Row key={o._id} justify="between" wrap={false}>
433
+ <Stack gap={1}>
434
+ <Text num>{money(o.total, o.currency ?? CURRENCY)}</Text>
435
+ <Text size="sm" muted>
436
+ {new Date(o.createdAt).toLocaleDateString()} · {plural(o.lines.reduce((n, l) => n + l.qty, 0), "item", "items")}
437
+ </Text>
438
+ </Stack>
439
+ <Badge tone={ORDER_STATUS[o.status]?.tone ?? "info"}>{ORDER_STATUS[o.status]?.label ?? "Received"}</Badge>
440
+ </Row>
441
+ ))}
442
+ </Stack>
443
+ </Card>
247
444
  )}
248
- {checkout}
249
- <Text size="sm" muted>
250
- No payment is taken here. We confirm your order and arrange payment when you collect.
251
- </Text>
252
445
  </Stack>
253
- </Card>
254
-
255
- {mine.length > 0 && (
256
- <Card variant="tight">
257
- <Stack gap={3}>
258
- <Heading level={3}>Your orders</Heading>
259
- {mine.map((o) => (
260
- <Row key={o._id} justify="between" wrap={false}>
261
- <Stack gap={1}>
262
- <Text num>{MONEY.format(o.total)}</Text>
263
- <Text size="sm" muted>
264
- {new Date(o.createdAt).toLocaleDateString()} · {plural(o.lines.reduce((n, l) => n + l.qty, 0), "item", "items")}
265
- </Text>
266
- </Stack>
267
- <Badge tone={ORDER_STATUS[o.status]?.tone ?? "info"}>{ORDER_STATUS[o.status]?.label ?? "Received"}</Badge>
268
- </Row>
269
- ))}
270
- </Stack>
271
- </Card>
272
- )}
273
- </Stack>
274
- </div>
275
- </Grid>
446
+ </div>
447
+ </Grid>
448
+ </>
449
+ )}
276
450
  </Stack>
277
451
  <div className="ui-toasts">
278
452
  <Toaster />
@@ -284,10 +458,11 @@ export default function App() {
284
458
 
285
459
  ## Adapting
286
460
 
287
- - Swap `PRODUCTS` for the shop's own catalogue; a catalogue the owner edits in the app becomes `product` documents behind an owner-only `can.create`, read with `useLiveQuery("type", { key: "product" })`.
288
- - Keep the order a snapshot of names, prices and quantities: an order is a record of what was agreed, so a later price change must not touch it.
461
+ - The catalogue is records, so a shop with three things and a shop with forty are the same code. It ships empty: example products for a first look go in the app's seed data, which the owner clears, and the owner adds the real ones on **Products**. Swap `CATEGORIES`, `BADGES`, the shipping rule and `CURRENCY` for the shop's own.
462
+ - Product records belong to the owner: `access.js` takes a `product` only from the owner (`ctx.requireRole("owner")`), with an `amount` that is a positive whole number, a three-letter lowercase `currency` and an `onSale` true or false, and puts it on a channel every visitor reads. Keep the `orders` database and the field names `title`, `amount`, `currency` and `onSale`: they are the `stripe` skill's, so its checkout reads these records and prices this bag unchanged.
463
+ - Keep the order a snapshot of titles, unit prices and quantities: an order is a record of what was agreed, so a later price change must not touch it.
289
464
  - Orders hold who bought what, so `access.js` and the app's sharing should keep each order between its buyer and the shop: a buyer creates and reads their own, the shop reads them all and moves each through `ORDER_STATUS` behind `can.edit(order)`.
290
- - Real payment is the `stripe` skill, and it comes in only when the person asks to take money; until they do, keep the "no payment is taken here" line truthful, and offer `▸ [pay] Take card payments with Stripe` as the capability option.
465
+ - Card payment is the `stripe` skill, and it comes in when the person asks to take money: its checkout replaces `Place order` with one `pay(...)` that sends each product and its quantity, `backend.js` prices every line from these records, and the order becomes the one `/checkout` writes. Until then, keep the pay-when-you-collect line truthful, and offer `▸ [pay] Take card payments with Stripe` as the capability option.
291
466
  - A new write surface gets its own verdict: `can.create(draft)` with the fields the write stamps, `can.edit(doc)` or `can.delete(doc)` on the document it changes, always on `useVibe` of the database it writes.
292
467
 
293
468
  Adapted from 1st-Pouf (MIT) https://1st-pouf.worksonmy.dev/r/storefront.json
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vibes.diy/prompts",
3
- "version": "14.3.204",
3
+ "version": "14.3.205",
4
4
  "type": "module",
5
5
  "main": "./index.js",
6
6
  "exports": {
@@ -39,10 +39,10 @@
39
39
  "license": "Apache-2.0",
40
40
  "dependencies": {
41
41
  "@adviser/cement": "~0.5.34",
42
- "@vibes.diy/api-types": "14.3.204",
43
- "@vibes.diy/call-ai-v2": "14.3.204",
44
- "@vibes.diy/identity": "14.3.204",
45
- "@vibes.diy/use-vibes-types": "14.3.204",
42
+ "@vibes.diy/api-types": "14.3.205",
43
+ "@vibes.diy/call-ai-v2": "14.3.205",
44
+ "@vibes.diy/identity": "14.3.205",
45
+ "@vibes.diy/use-vibes-types": "14.3.205",
46
46
  "arktype": "~2.2.8",
47
47
  "json-schema-faker": "~0.6.3"
48
48
  },
@@ -455,7 +455,7 @@ Rules for the items:
455
455
 
456
456
  A second visitor should arrive at a party, not a parking lot: within five seconds of the app opening there is something to react to — seeded life, a visible trace of activity, one obvious fun thing to do. Build that in by default — except where noted, private-by-nature apps (a diary, journal, health/finance log — anything whose core purpose is personal record-keeping) and strictly solo tools skip the social bullets and get their aliveness from vivid copy and motion instead:
457
457
 
458
- - **Every first build of an app that holds records ships a `seed.json` demo.** On the turn that first creates the app, emit a `seed.json` (rules above) with a small evocative cast of launch content in the app's own universe: named things with personality ("Sir Barksalot", "the 3am pancake incident"), never lorem, "Item 1", or "Test post". The file is the demo — the platform's screenshot renders it in a sandbox database, and it reaches the live app only when the person asks for the examples or taps the seed option — so it ships whether the request is open-ended or specified, whether the records are shared or private-by-nature (a diary's seed is a few vivid entries nobody but the demo ever sees), and whether the owner authors the content for others — a menu, a price list, a schedule — or keeps it for themselves. What the request's specificity sets is the screen, not the file: a specified request opens empty and ready for the person's first entry while its demo lives in `seed.json`, and an open-ended one opens showing a world already in motion rather than a form asking to be filled. The one app with no seed is a stateless toy that stores nothing — a sound toy, a sandbox that saves no record. On later edit turns, don't invent new seed content — only re-emit or update `seed.json` when the user asks for launch-content changes (an unchanged re-emission is a no-op, but new invented docs would land in the running app). Seed docs are written **as the owner** at launch, and applying them stamps nothing on a record, so personality lives in content fields (titles, descriptions, names) while a record keyed on its writer (`authorHandle`, `creatorHandle`, `hostHandle`) carries `"@owner"` — the platform fills in the owner's handle, the value the app's rules compare against the writer.
458
+ - **Every first build of an app that holds records ships a `seed.json` demo.** On the turn that first creates the app, emit a `seed.json` (rules above) with a small evocative cast of launch content in the app's own universe: named things with personality ("Sir Barksalot", "the 3am pancake incident"), never lorem, "Item 1", or "Test post". The file is the demo — the platform's screenshot renders it in a sandbox database, and it reaches the live app only when the builder adds it to a first build that reads better full, the person asks for the examples, or they tap the seed option — so it ships whether the request is open-ended or specified, whether the records are shared or private-by-nature (a diary's seed is a few vivid entries nobody but the demo ever sees), and whether the owner authors the content for others — a menu, a price list, a schedule — or keeps it for themselves. What the request's specificity sets is the screen, not the file: a specified request opens empty and ready for the person's first entry while its demo lives in `seed.json`, and an open-ended one opens showing a world already in motion rather than a form asking to be filled. The one app with no seed is a stateless toy that stores nothing — a sound toy, a sandbox that saves no record. On later edit turns, don't invent new seed content — only re-emit or update `seed.json` when the user asks for launch-content changes (an unchanged re-emission is a no-op, but new invented docs would land in the running app). Seed docs are written **as the owner** at launch, and applying them stamps nothing on a record, so personality lives in content fields (titles, descriptions, names) while a record keyed on its writer (`authorHandle`, `creatorHandle`, `hostHandle`) carries `"@owner"` — the platform fills in the owner's handle, the value the app's rules compare against the writer.
459
459
  - **Generated images as content, not decoration.** Where pictures naturally belong (avatars, covers, cards, monsters, prizes), render them with `<ImgGen>` and a vivid specific prompt — never a placeholder box or a generic prompt like "an image".
460
460
  - **Motion on state changes.** Small fast transitions (150–300ms) when things appear, complete, or score — enough that actions feel acknowledged, not a light show.
461
461
  - **Empty states invite, they don't announce.** "Draw the first monster" with the button right there, not "No data yet".