What this is

Playwemo is a Node library you drop into Playwright. The same spec can stay a fast test and also become a followable walk: chapter banners, a teaching cursor, paced typing, a click storyboard, an email-safe transcript, and (when you ask for it) a stitched walk.mp4.

It is not a test runner and not a product fixture kit. Login buttons, inbox locators, and persona names stay in your app.

Two speeds

You run	You get	When
Spec with E2E_DEMO unset	Teaching stills (pointer + held ring + demo bar) + transcript.txt	Writing the walk, CI
Same spec with E2E_DEMO=1	Paced cursor, optional walk.mp4 (no mid-walk still)	After the stills look right

Do not keep a “CI walk” and a “demo walk.” The flag changes chrome and timing, not the story. Assertions stay on both paths.

Where to go

1. Getting started — install, configure, first shot
2. Stills — the daily loop (storyboard PNGs)
3. Examples — this site’s own walk, as stills
4. Writing a walk — runDemoWalk, chapters, fills
5. Video — headed path, stitch, walk.mp4
6. Cursor — show stills and walk.mp4 in a Cloud Agent thread

Agents: start at llms.txt or For agents. Do not scrape the HTML.