Skip to content

docs(demo): captioned demo media + README gif (P4.7) - #59

Merged
franciszver merged 1 commit into
mainfrom
docs/p4-demo-media
Jul 24, 2026
Merged

docs(demo): captioned demo media + README gif (P4.7)#59
franciszver merged 1 commit into
mainfrom
docs/p4-demo-media

Conversation

@franciszver

Copy link
Copy Markdown
Owner

Closes #58

Summary

Adds a captioned demo of the live app to the README, plus a reusable build pipeline.

  • docs/assets/demo.gif (tracked, 706 KB, embedded near the top of the README) — 7 captioned screens of the live demo, 3s each, looping.
  • .demo-media/demo.mp4 (gitignored, delivered separately) — same frames with a gentle stdlib-synthesized soundtrack; confirmed AAC audio stream.
  • scripts/build_demo_media.py — PNG frames → captioned gif + mp4. Pillow for captions/gif; bundled ffmpeg via imageio-ffmpeg for the mp4; music synthesized with stdlib wave+math (no numpy). --no-music toggle.
  • scripts/test_build_demo_media.py — hermetic pytest tests, importorskip-gated (skip cleanly where Pillow/ffmpeg absent): caption changes the frame, music-on→audio / off→none, odd dimensions don't crash. 4 passed.

The 7 screens

login → dashboard → editor → clause library → jurisdiction/AI-context → AI suggestions → admin audit trail, captions in .demo-media/captions.json.

Notes for review

  • Slot 5 substitution: there is no reachable Bluebook-citations UI in the running app — CitationBrowser/CitationManager are orphaned (not imported by any page), so the capture used the editor's jurisdiction/AI-context panel instead ("AI-tailored to your jurisdiction"). Worth deciding later whether to wire those components in or drop the citation feature from the marketing copy.
  • Verified by eye: two captioned frames opened and confirmed legible; gif = 7 frames; mp4 has an audio stream.
  • CI here is JS-only, so the Python pipeline tests run locally (they were run: 4 passed), not in CI.
  • Left open for owner review because it changes the public README (per the public-facing-text approval rule). The mp4 is delivered as a file, not committed.

🤖 Generated with Claude Code

Capture 7 live-demo screens -> captioned demo.gif (tracked, 706KB, embedded
near the top of the README) + demo.mp4 with a stdlib-synthesized soundtrack
(gitignored, delivered as a file). Pipeline script build_demo_media.py
(Pillow + bundled ffmpeg via imageio-ffmpeg; music via wave+math, no numpy)
with hermetic pytest tests (importorskip-gated: caption changes the frame,
music on->audio / off->none, odd dimensions don't crash).

Raw frames and the mp4 stay under the gitignored .demo-media/ working dir.

Closes #58

Assisted-by: Claude Code (Fable orchestrator + Sonnet implementers)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@franciszver
franciszver merged commit 7e38464 into main Jul 24, 2026
2 checks passed
@franciszver
franciszver deleted the docs/p4-demo-media branch July 24, 2026 19:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

P4.7: Captioned demo media (mp4 + gif with music) + README embed

1 participant