Use lightweight media in git and host full recordings elsewhere.
- Record a product demo locally.
- Export a small poster image and commit it under
docs/assets/. - Upload the full video to YouTube, GitHub Releases, or another stable public host.
- In
README.md, show the poster image and link it to the hosted video.
GitHub README files do not support arbitrary embedded YouTube iframes. The most reliable pattern is a clickable poster:
[](https://www.youtube.com/watch?v=0RBsNySsgOs)docs/assets/demo-poster.jpg: lightweight poster extracted from the local autoplay recording.- YouTube demo: https://www.youtube.com/watch?v=0RBsNySsgOs
test-results/no-title.mp4: local recording source, ignored by git.
Avoid committing large videos unless they are intentionally versioned release assets.