From 70d0e36ad32226d5eddd98e01921190bf597983d Mon Sep 17 00:00:00 2001 From: doxa-maps-88655c70 <88627970+doxa-maps-88655c70@users.noreply.github.com> Date: Mon, 21 Sep 2026 07:38:50 +0000 Subject: [PATCH] point the tutorial at the studio folder and separate build from publish --- docs/tutorial.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/tutorial.md b/docs/tutorial.md index 118ab32fd..b326dbc1f 100644 --- a/docs/tutorial.md +++ b/docs/tutorial.md @@ -29,7 +29,8 @@ want in plain English. Most days you live in steps 3 and 4. 1. **Clone the repo** to your computer. *(Once, ever.)* -2. **Go into the maps folder:** `cd doxa-maps`. +2. **Go into the maps folder:** `cd doxa-maps-plugin-studio`. (The folder is the *studio* — a + sibling `doxa-maps/` may also exist; it is a different, older tree and has no `plugin-designs/`.) 3. **Run `bun run dev`.** Your staging page opens, showing **all** your maps. 4. **Make changes** — or tell an AI agent to — and watch them appear **instantly**. 5. **When you're happy, run `bun run build`.** This packages your maps for the website. @@ -45,7 +46,7 @@ Most days you live in steps 3 and 4. Open a terminal and step into the maps folder: ```bash -cd doxa-maps +cd doxa-maps-plugin-studio ``` > **One-time setup:** this project uses **Bun**. Install it from , then run @@ -166,7 +167,7 @@ is in **[how-to.md](./how-to.md)**. | You type | What happens | |---|---| | `bun run dev` | Opens your live workshop showing **every** map. Changes appear instantly (HMR). No build. This is where you spend your time. | -| `bun run build` | Packages your maps into `public/`. The **only** step that publishes. Run it when you're ready to ship. | +| `bun run build` | Packages your maps into `public/` — the served web-root. The **only** build step you need. (Putting them on the live platform is a separate publish; see [develop-a-plugin-and-see-it-live.md](./develop-a-plugin-and-see-it-live.md).) | `dev` is for **creating**; `build` is for **shipping**.