#video command bundles video files into your app for in-app playback. Use it for onboarding videos, tutorials, background loops, or any video content that should ship with your app.
What It Does
When you use#video, the AI:
- Adds the video file to your Xcode project as a bundled resource
- Sets up a video player using AVKit and AVFoundation
- Configures playback behavior (autoplay, looping, controls) based on your description
Supported Formats
| Format | Notes |
|---|---|
| MOV | Apple’s QuickTime format, widely supported on Apple platforms |
| MP4 | Universal format, great compatibility and compression |
| QuickTime | QuickTime-compatible video files |
How to Use
Select your video file
The file picker opens, filtered to supported video formats. Choose the video you want to embed.
Describe how to use it
The video appears as an orange chip below the input. Tell the AI where to place the video and how it should behave.
Example Prompts
Common Video Patterns
Background video loops
Background video loops
Great for login screens and landing pages. Tell the AI to loop the video, mute it, and place it behind your content. Keep these videos short (5-15 seconds) and visually subtle.
Tutorial and onboarding videos
Tutorial and onboarding videos
Walk new users through your app with a video on each onboarding step. These typically include playback controls and play once.
Product or content previews
Product or content previews
Embed preview clips that users can watch inline. These usually have play/pause controls and expand to fullscreen on tap.
Tips for Smaller File Sizes
| Approach | How it helps |
|---|---|
| Use MP4 with H.264 | Best compression-to-quality ratio for most use cases |
| Shorten the clip | Trim to only the essential footage |
| Reduce resolution | 720p is often sufficient for mobile playback |
| Lower the frame rate | 24fps or 30fps is fine for most app videos |
| Compress with HandBrake | Free tool that can significantly reduce file size |
If your video is purely decorative (like a background loop), consider using a Lottie animation instead. Lottie files are dramatically smaller and resolution-independent.
Related
Toolkit Overview
See all available # commands and how the toolkit works.
#sound — Audio Files
Add sound effects and audio to your app.