UI Journey

Overview

Capture progressive screenshots of a web project as it hits development milestones, recorded in an append-only manifest, then generate a playback viewer that lets anyone step through the development journey.

Core principle: loose PNG files are just pixels. The manifest — label, caption, git SHA, ordering — is what makes a journey replayable. Never capture a screenshot without recording it in the manifest. The manifest records a git SHA, but the manifest file itself need not live in the code repo — it can live in an external docs vault (see "Output location" below).

When to Use

• A milestone or feature has landed and its visual state is worth recording.
• You want a "this is how the UI evolved" history for a README, wiki, or demo.
• Existing Playwright tests should leave behind a visual record, not just pass/fail.