Sample data
Demo data is plain JSON — no database. The preview reads one dataset at a time; carts, logins and orders live in memory and start afresh when you switch.
Built-in datasets
| Id | Name | Stores | Products | Categories | Description |
|---|---|---|---|---|---|
normal | Normal (2 stores) | 2 stores (shopper chooses) | 42 | 7 | Typical store: two active branches plus one closed branch, so shoppers must choose a store. 30 products in 6 departments (variants, low stock, sold-out items), coupons, delivery areas, two payment methods and a customer account. |
single-store | Single store | one store (auto-selected) | 30 | 6 | Exactly one active store: it is selected automatically, there is no store chooser and no "Shopping at" button. Full catalogue. |
small | Small shop | one store (auto-selected) | 4 | 1 | One store, one category, one brand and four products: brand blocks hide (they need 2+ brands), promotion slots beyond the first category hide, there is no pagination. |
empty | Empty catalogue | one store (auto-selected) | 0 | 0 | One store with no categories, brands or products and no delivery areas. Use it to check empty states: every product, category, brand and promotion block should hide or show a friendly message. |
large | Large catalogue | 3 stores (shopper chooses) | 660 | 12 | Three stores, 12 categories, 24 brands and 600 products in the first store (30 pages), to check pagination, long category lists, mega menus and performance. |
edge-cases | Edge cases | 2 stores (shopper chooses) | 15 | 4 | Awkward but valid data: very long names and descriptions, non-Latin text and emoji, HTML-like text (must be shown as text), missing and broken images, an external image URL, zero prices, prices in the millions, everything sold out in one category, a product with many variants, and a store without opening hours or description. |
no-stores | Single-site (no stores) | single-site (no stores configured) | 12 | 6 | No store records at all: the application runs as a single shop (legacy mode). Store placeholders such as {STORE_PHONE} are empty and there is no store chooser. |
stores-paused | All stores closed | online shopping paused (no active store) | 6 | 6 | Stores exist but none is active: the storefront shows "Online shopping is paused" and no products. |
Your own datasets
Add .json files to your template's sample-data/ folder; they appear as project:<file name> in the Studio, node sdk preview --dataset and node sdk test --dataset. Start from a copy of a built-in file in the SDK's datasets/ folder.
Format
{
"name": "My data", "description": "…", "notes": ["…"],
"store": { "name", "description", "currency", "currencySymbol", "taxRate", "minOrderAmount",
"onlineOrders", "urlStructure": "hash"|"path", "timezone", "lowStockThreshold" },
"payments": [ { "id": "cash_on_delivery"|"bank_transfer"|…, "name", "description", "enabled", "details" } ],
"stores": [ { "id", "name", "description", "status": "active"|"inactive", "address", "city", "state", "zip",
"phone", "email", "timezone", "hours": { "monday": {"open","close"}|null, … },
"taxRate", "minOrderAmount", "pickup", "delivery" } ],
"categories": [ { "name", "subcategories": ["…"] } ],
"brands": [ { "name" } ],
"products": [ { "id", "storeId"|null, "name", "description", "category", "subcategory", "brand", "currency",
"images": ["/uploads/sample/x.svg" | "/image/x.png" | "https://…"], "tags", "weight",
"popularity", "createdAt", "status": "active"|"draft", "lowStockThreshold",
"variants": [ { "id", "name", "sku", "price", "stock", "attributes": {}, "active" } ] } ],
"coupons": [ { "code", "storeId"|null, "type": "percentage"|"fixed"|"free_shipping", "value",
"minOrderAmount", "startsInDays", "expiresInDays" } ],
"deliveryAreas": [ { "id", "name", "storeId"|null, "places": [ { "id", "name", "fee", "freeOver", "feeFormula" } ] } ],
"customers": [ { "id", "name", "email", "password", "phone" } ],
"images": { "file.svg": { "label", "color" } } (pictures the preview draws for /uploads/sample/…)
}
- No stores → single-site mode (no store chooser). One active store → it is chosen automatically. Several active stores → shoppers choose. Stores but none active → "online shopping is paused".
- Products belong to a store through
storeId(null in single-site mode). The first variant gives the price and stock; products with several variants need an option chosen before adding to the cart. - Coupons:
percentage,fixed(amount off) orfree_shipping, optionally for one store and with a minimum order. - Delivery areas: places with a fee (
fee), optional free delivery from an order value (freeOver) or a weight formula (feeFormula, e.g.B+W*100: base fee plus 100 per kg). - Pictures:
/uploads/sample/<file>.svglisted inimagesare drawn by the preview;/image/…uses your template's images; external URLs show a placeholder, as the store's image proxy would. - Customers log in with their email and the password in the file (demo only).