Skip to content

Add a demo video to the README - #30

Merged
DevMando merged 1 commit into
mainfrom
docs/add-demo-video
Jul 29, 2026
Merged

Add a demo video to the README#30
DevMando merged 1 commit into
mainfrom
docs/add-demo-video

Conversation

@DevMando

Copy link
Copy Markdown
Owner

Summary

Adds a short demo clip at the top of the Screenshots section, above the static screenshot grid —
a video's the strongest first thing a visitor should see.

It's uploaded via GitHub's own attachment CDN (dragged into a comment editor to get the
user-attachments link), pasted as a bare URL rather than wrapped in markdown — that's what makes
GitHub render it as a real inline <video> player with controls, instead of a click-through link.

Worth noting for future reference: getting a working upload took some trial and error. File size
and resolution weren't actually the blocker — a 16MB/720p re-encode still failed to upload, while a
tiny 3-second synthetic test clip worked instantly. The real constraint turned out to be video
duration
: uploads succeeded at 55 seconds and failed at 60, so the cap sits somewhere in that
5-second window. Landed on a 55-second clip to stay safely under it.

Test plan

  • README renders the video as an inline, playable clip on github.com (not just a link)
  • Video plays correctly and audio is present

Uploaded via GitHub's attachment CDN (drag-and-drop into a comment editor),
which is what makes it render as a real inline player rather than a link
out to another site. Landed on a 55-second clip after finding the actual
constraint the hard way: GitHub's attachment upload has a duration cap
somewhere between 55 and 60 seconds — file size, resolution, and audio
were all red herrings once a 16MB/720p re-encode still failed and a
trivial 3-second synthetic clip succeeded instantly.
@DevMando
DevMando merged commit 0db819b into main Jul 29, 2026
1 check passed
@DevMando
DevMando deleted the docs/add-demo-video branch July 29, 2026 00:38
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.

1 participant