feat(demo): add recorded realworld-simulation demo (GIF + MP4 + tape)#35
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Adds an above-the-fold, reproducible “Current web (HTML) vs EEP” recorded demo to improve first-time repository comprehension, with committed artifacts and instructions for regenerating them deterministically.
Changes:
- Add and embed a recorded terminal demo GIF in the root README header (with a link to reproduction steps).
- Add a deterministic VHS tape script (
demo.tape) and documentedvhs/ffmpegregeneration recipe. - Update
realworld-simulation/.gitignoreto avoid committing intermediate recording outputs from reruns.
Reviewed changes
Copilot reviewed 4 out of 6 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | Embeds the demo GIF near the top of the README and links to reproduction instructions. |
| assets/realworld-demo.gif | Adds the optimized GIF artifact used for the README embed. |
| assets/realworld-demo.mp4 | Adds the full-length MP4 recording artifact. |
| realworld-simulation/demo.tape | Adds the VHS script to record the demo deterministically. |
| realworld-simulation/README.md | Documents how to regenerate the MP4/GIF artifacts via vhs + ffmpeg. |
| realworld-simulation/.gitignore | Ignores local recording outputs so reruns don’t pollute git status. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+94
to
+98
| # 1. Run the demo recording (uses VHS — brew install vhs) | ||
| vhs demo.tape | ||
|
|
||
| # 2. Trim to the last 15s (the Scenario B run + comparison table) | ||
| ffmpeg -y -sseof -15 -i realworld-demo.mp4 -c copy realworld-demo-short.mp4 |
| @@ -0,0 +1,17 @@ | |||
| # EEP Realworld Simulation — VHS recording script | |||
| # Run with: vhs demo.tape | |||
| # Outputs an MP4 of the deterministic Old-Web-vs-EEP comparison. | |||
ucekmez
force-pushed
the
chore/realworld-demo-recording
branch
from
aadee16 to
2055b92
Compare
- assets/realworld-demo.mp4: 15.7s split-screen recording (7.2 MB, h264, 1800x950) - assets/realworld-demo.gif: optimized GIF for README (4.2 MB, 10fps, 1000px wide) - realworld-simulation/demo.tape: VHS script that runs the demo in DEMO_SPLIT_SCREEN=1 mode so Scenario A (current web) and Scenario B (EEP) run in parallel panes - realworld-simulation/README.md: documents the regeneration recipe (vhs + ffmpeg + gifsicle) - README.md: embeds the GIF in the project header with descriptive alt text The recording opens directly on the two parallel panes (server startup is trimmed) and runs through both scenarios in parallel — EEP pane finishes in ~10 s while the current-web pane is still doing Playwright extraction at ~26 s. Final comparison table appears full-width after both complete. Signed-off-by: Ugur Cekmez <ucekmez@gmail.com>
ucekmez
force-pushed
the
chore/realworld-demo-recording
branch
from
2055b92 to
0531c07
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a recorded demo of the Current-Web-vs-EEP simulation and embeds it in the README header.
What this adds
assets/realworld-demo.mp4assets/realworld-demo.gifrealworld-simulation/demo.taperealworld-simulation/README.mdREADME.mdWhy this matters
The repo currently has no visual demo above the fold. The first-impression for a HN/Reddit/Twitter visitor is a wall of badges. With this PR, the README opens on a deterministic, no-LLM-spend demo that makes the value prop visible in 15 seconds.
The numbers in the comparison table do the work:
Reproducible
realworld-simulation/demo.tapelets anyone regenerate the recording (afterbrew install vhs). The README adds a tiny block showing theffmpegpalette/scale step that turns the raw MP4 into the optimized GIF (1.5 MB).realworld-simulation/.gitignoreis updated so re-runningvhs demo.tapedoesn't pollute the workspace — the canonical artifacts live inassets/.Out of scope (intentional)