Every launch retrospective we studied names the above-the-fold demo GIF as the single biggest README conversion lever; it gates the Show HN / Reddit wave.
- Record a real
loop run — scaffold via npm create @loop.js, a small honest Goal, at least one not-yet verdict with its reason, then the settling verdict — so the judged-loop model is visible in ~20s.
- Render with vhs or asciinema→GIF; keep it legible at README width.
- Place above the fold in README.md and on the docs landing page.
Every launch retrospective we studied names the above-the-fold demo GIF as the single biggest README conversion lever; it gates the Show HN / Reddit wave.
loop run— scaffold vianpm create @loop.js, a small honest Goal, at least one not-yet verdict with its reason, then the settling verdict — so the judged-loop model is visible in ~20s.