Skip to content

Fix introduction hero video: serve from S3, drop 66MB mp4#26

Merged
biswaroop1547 merged 1 commit into
mainfrom
fix/introduction-hero-video
Jul 2, 2026
Merged

Fix introduction hero video: serve from S3, drop 66MB mp4#26
biswaroop1547 merged 1 commit into
mainfrom
fix/introduction-hero-video

Conversation

@charitra-prem

Copy link
Copy Markdown
Contributor

Problem

The introduction hero video (added in #23) didn't play. It was committed as a 66MB, 1080p / 11.5 Mbps .mp4 inside the repo and embedded via <Frame> with a <source> child. A binary that large is past GitHub's 50MB warning and won't reliably serve through Mintlify, so the player rendered nothing. The original also lacked faststart, which makes browsers wait for the full download before playing.

Fix

  • Re-encoded the clip to H.264 1080p ~1 Mbps with +faststart66MB → 5.7MB, no visible quality loss.
  • Hosted on S3, not git. Uploaded to the public fluso-docs-assets bucket (us-east-1) at introduction/fluso-brand-video-v7.mp4 with Content-Type: video/mp4 and a 1-year immutable cache header. Verified 200 + Accept-Ranges: bytes + range requests return 206 (seeking works).
  • Fixed the embed to a plain Mintlify <video> tag (their documented pattern) pointing at the S3 URL; dropped the <Frame> wrapper (that's the image component).
  • Removed the mp4 from git and added *.mp4/*.mov/*.webm to .gitignore so large media stays out of source control.

URL: https://fluso-docs-assets.s3.us-east-1.amazonaws.com/introduction/fluso-brand-video-v7.mp4

Note: the bucket serves directly from S3 (no CloudFront). Fine for a single small file; edge caching / a branded domain can be added later.

🤖 Generated with Claude Code

The video was committed as a 66MB 1080p/11.5Mbps mp4 and embedded via
<Frame> with a <source> child. A file that large won't reliably serve
through Mintlify (past GitHub's 50MB warning), so the player showed
nothing.

- Re-encode to H.264 1080p ~1Mbps + faststart (66MB -> 5.7MB, no visible
  quality loss) and host on the public fluso-docs-assets S3 bucket.
- Embed with a plain Mintlify <video> tag (className sizing, muted,
  playsInline, preload=metadata) pointing at the S3 URL.
- Remove the binary from git and gitignore *.mp4/*.mov/*.webm so large
  media stays out of source control.
@mintlify

mintlify Bot commented Jul 2, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
premai-913c930f 🟡 Building Jul 2, 2026, 7:11 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@biswaroop1547 biswaroop1547 merged commit b0b70eb into main Jul 2, 2026
3 checks passed
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.

2 participants