A power-tool store built natively on Crystallize

A tool has two shared pieces, power (source, voltage, motor) and physical (weight, size, vibration, noise), and one spec family chosen per product: drilling, concrete, sawing, abrasive, woodworking, fastening, installation, measuring, extraction, battery-charging, site, storage, outdoor or consumable. The family is a single choice, so a breaker cannot carry a saw’s fields.

Numbers are numeric components with a unit (230 Nm, 18 V, 5 Ah), yes/no are booleans, fixed sets are selections. 106 components carry their ETIM 10.0 feature, and the spec labels in Norwegian, Swedish and Dutch are ETIM’s official names. Each product sits in its ETIM class.

The same typed values drive the category facets (range filters on impact energy, blade diameter …), the spec sheet, the JSON-LD with UN/CEFACT unit codes, and the assistant’s and MCP server’s spec filters.

Impact energy

specs.concrete.impactEnergy · J (JOU) · EF002831

Tool holder

specs.concrete.toolHolder · SDS-max · EV005657

Weight

physical.weight · kg (KGM) · EF011121

Brand, battery platform, product type, trade, material, level, price tier, feature, availability, image type and ETIM class: 188 topics. They drive navigation, facets and the taste vectors.

Brands, battery platforms and technologies are documents with their own story pages. The battery platform (Milwaukee M18, Makita LXT, Hilti Nuron …) is the decision a professional has already made: it decides which batteries fit, and it is the strongest signal in personalisation. Accessories, blades and batteries name the machines they fit; machines have the manufacturer’s pairings.

Each rental item is a bookable product with a pool of named units, the physical machines. The storefront shows live availability per depot and period from the Shop API, books the unit into the basket, and confirms the booking at checkout, linked to the order.

Three booking policies set lead times and a cancellation window of 24 or 48 hours: inside it, a rental can still be removed from the basket and the unit is released. Operator certificates, deposits and site delivery are part of the rental item.

English and Dutch sell in EUR (21% VAT), Norwegian in NOK and Swedish in SEK (25%). Prices are stored net, per currency, with volume tiers. The incl./excl. VAT toggle in the top bar switches every price on the page; trade accounts default to excl.

Trade customers get their company’s price list from Crystallize markets: Discovery returns nokPriceFor(marketIdentifiers) and the Shop API cart uses the same list. Invoice with PO reference, quotes into their own pipeline, and an account page with orders, rentals and quotes by stage.

Topics become three vocabularies: ecosystem (brand and platform), work (trade and material) and gear (product type, level, features). Every product has a vector in each. A customer’s taste vector is built from their order history in the Shop API and sent with each query as context.userTaste, with a rankBy rule that blends it with sales, margin and stock.

Switch demo customer in the header and the store re-ranks: the front page, the category order, the mega-menu images, pairings and alternatives. Sindre, a cabinetmaker who only buys Festool, has the clearest vector; Lotte, a weekend woodworker on DeWalt, sees a very different store.

Specs, list prices and images come from the six manufacturers’ own sites, gathered by research agents and normalised into the model with a source per product. Product copy is written for the demo. Bosch, Festool and Hilti prices are list prices; the rest, and NOK and SEK, are estimated and rounded to shelf price points. Depots, units, customers and review counts are fictional.

npm run seed runs ten steps in order: tenant settings, content model, taxonomy, images, catalogue, rental, translations, landing pages, vectors, customers. Every step can be rerun on its own; it updates what exists instead of duplicating it. Taste vectors are computed last, written to drafts, then published and indexed.

The build is recorded step by step for playback, and what the Crystallize skills should have told us is written down as it is found.

00–02

Tenant, 29 pieces and 11 shapes, 11 topic maps

03–05

1,104 images, 416 products, 24 rental items

06–07

Norwegian, Swedish, Dutch; landing pages

08–09

Vectors and index; customers and their history

The Ask button in the header opens a shopping assistant running on Claude with the store’s own tools: search with typed spec filters, product details, platforms, rentals and the basket.

The store is also an MCP server. Add it to Claude as a connector, sign in as a demo customer, and shop from the chat: compare tools on a platform, book a rental, fill a basket and check out in the store. Every page is set up to be read by search engines and language models as well.