[farhan-syah]

Summary

CI captures every screen of the real app as PNG, light and dark. The images live on an orphan screenshots branch, so they always match main and never enter the code history.

• Scene runner (screenshots feature, Linux only): drives the app through 39 scenes using the app's own signals and the backend seam. Each scene captures WebKitGTK's own snapshot at 2x. On other targets the feature compiles to nothing.
• scripts/screenshots.sh [dir]: builds and runs the capture under Xvfb. Writes light/*.png and dark/*.png.
• .github/workflows/screenshots.yml:
  • Pull request: runs the scene tests, uploads the PNGs as an artifact, and lists changed, added, and removed screens in the job summary (scripts/screenshots-diff.sh).
  • Push to main: a separate job with contents: write replaces the single commit on the screenshots branch. It skips the push when no screen changed.
• Theme fix: Preferences stored Light/Dark, but the stylesheet followed only the OS. The root now carries data-theme, and the dark tokens key on it.
• Docs: README gets a light/dark hero image, a gallery, and capture steps. AGENTS.md gets the command and the rule that a new screen needs a scene.

Notes

• Dependencies: webkit2gtk and cairo-rs (png feature) are optional and Linux-only. wry and tao already build both.
• README links: they return 404 until the first push to main creates the screenshots branch.
• Bare binaries: a bare binary, including cargo build --release output, renders unstyled. Dioxus loads asset! files from the source tree only under cargo run. The script uses cargo run, and README now says so.
• Unconfirmed package names: this PR's run is the first check of the Ubuntu 24.04 names fonts-inter and fonts-jetbrains-mono.

Test plan

• cargo clippy --workspace --all-targets --all-features -- -D warnings
• cargo clippy --workspace --all-targets -- -D warnings
• cargo nextest run --workspace --all-features: 283 passed
• scripts/screenshots.sh locally: 78 PNGs, byte-identical across two runs
• Screenshots workflow passes on this PR, and its artifact holds 78 PNGs