---
name: motion-bible
description: Create and enforce the Motion Bible design system for a video project. Use when establishing motion principles, defining brand animation rules, picking typography scales, locking easing curves, or auditing visual consistency across scenes.
---

# Motion Bible Design System

The Motion Bible is the foundational design contract for a motion graphics production. It guarantees visual coherence, aesthetic restraint, and brand precision across every frame.

## The Six Pillars of the Motion Bible

1. **Pacing and Rhythm**: Defines project frame rate (30 fps or 60 fps), default transition durations, and pause rules (e.g. minimum 0.7s readability hold for text blocks).
2. **Typography Scale and Hierarchy**: Locks approved font families, headline weights, uppercase labels, tracking, and line heights.
3. **Color Roles and Contrast**: Defines background, surface, border, primary accent, and status colors with verified WCAG contrast ratios.
4. **Motion Physics and Easing**: Mandates specific easing curves for UI elements (power3.out), playful pops (back.out), and snappy cuts (power4.out).
5. **Surface and Depth Treatment**: Establishes material rules: clear liquid glass, solid frosted panels, paper grain noise, or flat neobrutalist borders.
6. **Platform Safe Margins**: Specifies vertical and horizontal boundaries to prevent UI button occlusion on mobile feeds.

## Template and Structure

- [references/motion-bible-template.md](references/motion-bible-template.md) for the standard `motion-bible.md` template.