Getting started

Welcome to NanaSelect. This section is the front door — it orients a new maintainer or reviewer and hands off to the deeper how-to and reference material once you know your way around.

What NanaSelect is

NanaSelect is a standalone product-selection app that guides architects, builders, and homeowners to the right-sized NanaWall system, then hands off into the nanawall.com configurator and resources. It runs on SvelteKit + Cloudflare Workers with a D1 database, and owns its own product data. See the product vision for the full "why".

Start here

• Set up your first track — a screenshot-illustrated walkthrough that takes you from an empty admin to a working guided-selection track. Start here if you have never run the app.
• Admin access — how to reach the admin and sign in.

Once you're oriented

The rest of the docs follow the Diátaxis shape:

When you want to…	Go to
Perform a specific admin task	How-to guides — managing systems, attributes, factors, rules, media, tracks, page content
Understand how something works precisely	Reference — data model, recommendation API, corpus pipeline
Understand why the experience is shaped this way	Why it works — human-factors rationale and measurement plan
Deploy or hand the project over	Deployment & handover

Local development in one command

The fastest way to a fully testable environment is dev-up (or /dev-up in a Claude Code session), which reads dev.json and runs migrate → seed → serve → health-check. See the project README quick-start for the underlying pnpm commands.