# Tutorial live test (forced tour on :5174)

Date: 2026-08-04  
App: `http://127.0.0.1:5174` (Descrybe v2 web)  
Account: `demo@descrybe.local` (see [demo-user.md](./demo-user.md))  
Tooling: codehelper `browser` + session jar  

Related design doc: [tutorial.md](./tutorial.md)

## Checklist results

| Check | Result | Notes |
|-------|--------|-------|
| Start / Resume tutorial | PASS | Header + dashboard `data-tour` buttons open overlay |
| Continue absent on action steps | PASS | Step 2 (`standard-fields-nav`) shows Skip / Back / Pause only; hint "Click the highlighted control" |
| Nav click advances | PASS | Click `a[aria-label="Standard Fields"]` (`data-tour="nav-standard-fields"`) advanced to `enable-recommended` |
| Skip works | PASS | Skip -> `localStorage` `status: skipped`, header shows **Restart tutorial** |
| Restart works | PASS | Restart -> welcome step + **Let's go** |
| `npm run check` (apps/web) | PASS | 0 errors, 0 warnings |

## Sidebar redesign notes

Primary nav after redesign: Dashboard, Products, Feeds, Export, Stores, Billing, **More** (collapsed).

Tour targets under More (`nav-standard-fields`, `nav-campaigns`, ...) rely on `tutorialNeedsMore` in `Nav.svelte` to keep the More panel open while those steps are active. Live run confirmed More expands and Standard Fields is spotlighted.

Tour steps already point Stores via `data-tour="nav-stores"` and `store-connect-feed-url` (matches `store-connect-{card.id}` for `feed-url`).

## Known flakes / env

- Full page reload (`browser` `url=`) dismisses the in-memory overlay (`active=false`) while keeping `in_progress` → use **Resume**, not a mid-tour reload.
- Occasional CDP `context deadline exceeded` on a second nav click after Restart when Vite HMR is hot (not a product regression).
- During one advance, `/api/field-groups` and `/api/standard-fields` returned **502** (API proxy). Overlay still advanced to the enable-recommended step; action completion would need a healthy API.

## Storage

Key: `descrybe.tutorial.v2`  
Example after Skip: `{"version":2,"status":"skipped","stepId":"enable-recommended",...}`

## Commands

```bash
cd apps/web
npm run check
```