Skip to content

docs: re-encode videos that exceeded Mintlify's 20MB asset limit#721

Merged
ashpreetbedi merged 1 commit into
mainfrom
worktree-fix-video-size-limit
Jul 11, 2026
Merged

docs: re-encode videos that exceeded Mintlify's 20MB asset limit#721
ashpreetbedi merged 1 commit into
mainfrom
worktree-fix-video-size-limit

Conversation

@ashpreetbedi

Copy link
Copy Markdown
Contributor

Summary

Mintlify silently drops assets over 20MB at deploy, so three videos 404ed on the live site even though the files exist in the repo and the embeds are intact:

Video Page Before After
agentos-connect-and-chat.mp4 /first-agent#give-your-agent-a-ui 21.0MB (404) 2.9MB
dash-ui-demo.mp4 /deploy/templates/dash/overview 22.9MB (404) 1.6MB
agentos-api-scroll.mp4 /features/api 77.1MB (404) 4.4MB

The connect-and-chat video was over the cutoff by ~3KB, so it has likely never played in production. Verified the limit by testing every file in videos/: all under 20MB serve 200, all over 404.

Re-encoded with libx264 CRF 26 at 30fps. Resolution and duration unchanged; compared same-timestamp frames before/after and UI text stays crisp. These were the only three files in the repo over the limit.

🤖 Generated with Claude Code

Assets over 20MB are silently dropped at deploy, so these three videos
404ed on the live site (first-agent, features/api, templates/dash):

- agentos-connect-and-chat.mp4: 21.0MB -> 2.9MB
- dash-ui-demo.mp4: 22.9MB -> 1.6MB
- agentos-api-scroll.mp4: 77.1MB -> 4.4MB

Re-encoded with libx264 CRF 26 at 30fps; resolution and duration unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 11, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
agno 🟢 Ready View Preview Jul 11, 2026, 7:47 PM

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

@ashpreetbedi
ashpreetbedi merged commit ccea714 into main Jul 11, 2026
4 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.

1 participant