Skip to content

feat(get-started): embed 3:29 video walkthrough at the top of the page#29

Merged
paulgnz merged 1 commit into
mainfrom
feat/get-started-video
May 18, 2026
Merged

feat(get-started): embed 3:29 video walkthrough at the top of the page#29
paulgnz merged 1 commit into
mainfrom
feat/get-started-video

Conversation

@paulgnz
Copy link
Copy Markdown
Collaborator

@paulgnz paulgnz commented May 18, 2026

Self-hosted on Vercel. 13 MB / 506 kbps / 3:29 MP4 in frontend/public/get-started.mp4 with a poster frame extracted at the 8 second mark (47 KB JPG).

Layout

Sits above the role-selector — first thing a visitor sees on Get Started. Native <video> element with preload="none" so the file only downloads when the user clicks play (page load stays fast). The 6-step written guide remains canonical below, tied to the video with a small caption.

Why self-hosted (not YouTube / Vimeo / IPFS)

  • File is 13 MB at a well-tuned 506 kbps. Vercel's free 100 GB/month covers 7,700 views; tiers above are cheap ($20/100 GB).
  • No third-party tracking, no YouTube SDK loaded on every page view, no Google referrer leak — same self-hosted ethos as the rest of the stack.
  • One file, full control. Replacing the video is a 1-line git push.
  • preload="none" means bandwidth is paid per click, not per page view.

If the video later becomes a perf or bandwidth concern, switching to a CDN (Cloudflare R2, Cloudflare Stream, or YouTube unlisted with a privacy-friendly youtube-nocookie embed) is a 5-minute swap of the <source> URL.

Asset details

File Size What
frontend/public/get-started.mp4 13 MB The walkthrough video
frontend/public/get-started-poster.jpg 47 KB Frame extracted at 8s — shows in the player before click

13MB / 506 kbps / 209s MP4 self-hosted at /public/get-started.mp4
with a 47KB poster frame extracted at the 8s mark.

Sits above the role-selector — first thing a visitor sees on the
Get Started page. Native <video> element with preload="none" so the
file only downloads when the user clicks play (page load stays
fast). No YouTube embed, no Google referrer leak, no third-party
cookies — same self-hosted ethos as the rest of the stack.

Layout: max-w-4xl centered card with subtle proton-purple shadow,
aspect-video container so the player fills correctly at any
viewport. Falls back to a direct download link for browsers without
native <video> support.

Bandwidth math: Vercel free tier ships 100GB/month, which is ~7,700
views at 13MB each. Well above expected traffic for this surface;
cheap to scale past that ($20 / additional 100GB).

The written 6-step guide remains the canonical reference below — a
small "the written guide below covers the same flow with every
command copy-pasteable" caption ties the two together.
@paulgnz paulgnz merged commit e58cf48 into main May 18, 2026
5 checks passed
@paulgnz paulgnz deleted the feat/get-started-video branch May 18, 2026 21:59
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