descrybe/docs/tutorial-live.md

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)
Tooling: codehelper browser + session jar

Related design doc: 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

cd apps/web
npm run check