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 1,171 IKEA products (2,180 sizes, UK and US ranges) offline, built from IKEA's public listings (scripts/ikea)
- A hands-free voice: 1,476 pre-recorded Kokoro clips that play with no key, and Whisper on Together listening for "next" through an echo-cancelled mic (
/api/listen, hearIntent in src/lib/voice/commands.ts)
- Together AI on each visitor's own key (
src/components/KeyModal.tsx): drafts for products we don't have, photo lookup, and a help chat that answers with drawings of the exact panel, fitting or step
- Share cards drawn by the same engine (
scripts/og/render.mjs), an A4 print view, and a service worker so opened guides work with no signal
- Tests:
npm run voice:check replays 283 recorded listening runs, and npm run ikea:check tests every catalog row
Cloning & running
- Clone:
git clone https://github.com/Nutlope/bygga.git && cd bygga && npm install
- Run:
npm run dev, open http://localhost:3000 and type BISSA
- Jump to a step: http://localhost:3000/build/malm-3-drawers?step=12, or print the guide at
/build/malm-3-drawers/print
- See every build you've finished, side by side at true scale: http://localhost:3000/builds
- Try the AI parts:
cp .env.example .env.local, set TOGETHER_API_KEY, then paste bygga-dev-mock-key-000000 into the app's key box. The server swaps in your TOGETHER_API_KEY, and only npm run dev accepts the mock key.
- Replay the listening tests after touching the voice:
npm run voice:check
- Rebuild the catalog when IKEA's listings change:
npm run ikea:fetch && npm run ikea:build && npm run ikea:check
- Before pushing:
npm run lint && npm run build
Roadmap
License
MIT, see LICENSE. Bygga is not affiliated with IKEA: IKEA and its product names are trademarks of Inter IKEA Systems B.V., and the license grants no rights in them (see NOTICE).
