1# screenshots
2
3This directory contains tooling for automated terminal UI screenshot generation using [VHS](https://github.com/charmbracelet/vhs), a terminal recording and screenshot tool.
4
5## Architecture
6
7Screenshots are generated through a two-layer system:
8
91. **Go helper programs** (`cmd/`) that render realistic mock UI views using real Matcha components with fake data
102. **VHS tape scripts** (`.tape` files) that launch these programs and capture terminal output as images
11
12This pipeline runs in CI via the `.github/workflows/screenshots.yml` workflow to keep documentation screenshots up-to-date automatically.
13
14## Files
15
16### Helper Programs
17
18| File | Description |
19|------|-------------|
20| `cmd/inbox_view/main.go` | Renders a mock inbox populated with realistic email entries for screenshot capture. |
21| `cmd/email_view/main.go` | Renders a mock email view with headers, body content, and inline images for screenshot capture. |
22
23The rest are the tapes themselves