assemble.help: JYSK assembly, step by step

Not affiliated with JYSK. Guides are generated drawings: always check them against the official manual (see NOTICE).

Status

600 JYSK guides, built from the JYSK catalog by scripts/jysk. Live at assemble.help.

Tech stack

• Next.js 16 (App Router, Cache Components), React 19 and TypeScript, plain CSS with Motion, no UI kit
• A three.js line-art stage (src/engine) and a parametric plan generator (src/lib/plan) that draw each product offline from its catalog row
• A hands-free voice (pre-recorded Kokoro clips) and Together AI features on each visitor's own key; both are switched off for launch
• Share cards drawn by the same engine (scripts/og/render.mjs), an A4 print view, and a service worker so opened guides work offline

Running

1. git clone https://github.com/Trimud/jysk.git && cd jysk && npm install
2. npm run dev, then open http://localhost:3000
3. Before pushing: npm run lint && npm run build

Checks

npm run jysk:check builds every guide, then npm run qa:overlaps checks each model: no parts through each other, with doors and drawers closed or open, and no fittings floating in the air. GitHub Actions runs it on every push and pull request, and Vercel runs it before every build, so a guide that fails never deploys.

npm run qa:snapshots draws every view of the guides you changed (the finished piece, everything opened, X-ray and every step) and compares each with the drawing you last approved. Open .qa/report.html to see what changed, then keep it with npm run qa:snapshots -- --approve. It needs the dev server running (QA_BASE if it isn't on port 3000) and Playwright (PLAYWRIGHT_FROM, a folder whose node_modules has it). --only, --family and --all pick other guides; npm run jysk:build runs it on the families an import changed.

Credits and license

A fork of Bygga by its original authors, see CREDITS.md. MIT, see LICENSE.