Video Tutorials
Yes — Docusaurus supports video tutorials. This page is the proof referenced in the plan's verification. There are three supported ways to embed video; pick per source.
1. Self-hosted video (file in /static)
Place an MP4 in static/videos/ and use a standard HTML5 <video> tag inside MDX:
<video controls width="100%" preload="metadata">
<source src="/videos/onboarding-walkthrough.mp4" type="video/mp4" />
Your browser does not support the video tag.
</video>
Add captions for accessibility with a
<track kind="captions" src="/videos/onboarding.vtt" srclang="en" />.
2. YouTube / Vimeo embed
Use a responsive iframe (or the react-player component) in MDX:
<div style={{position:'relative', paddingBottom:'56.25%', height:0}}>
<iframe
src="https://www.youtube.com/embed/VIDEO_ID"
title="Technician App — Field Workflow"
style={{position:'absolute', top:0, left:0, width:'100%', height:'100%'}}
frameBorder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowFullScreen
/>
</div>
3. react-player (any source)
For mixed sources (YouTube, Vimeo, file, HLS) install react-player and import it in an MDX page:
import ReactPlayer from 'react-player';
<ReactPlayer url="https://youtu.be/VIDEO_ID" controls width="100%" />
react-playeris client-only; if SSR complains, wrap with Docusaurus<BrowserOnly>.
Planned tutorial set (to record)
| Tutorial | Audience |
|---|---|
| Onboarding a new brand from config | Ops |
| Authoring a blog post + newsletter (Payload → Listmonk) | Marketing |
| Technician app: complete a job offline | Technician |
| Dealer app: place an order + read your ledger | Dealer |
| Warranty registration & claim flow | Support |
| Setting up a Zapier/Pabbly automation | Admin |
Notes
- Keep large media in object storage/CDN or YouTube/Vimeo rather than the repo where possible (repo bloat).
- Captions/transcripts recommended for accessibility (mirrors our Lighthouse a11y budget).