loopwind 0.22.0 → 0.24.0

package/website/dist/llm.txt

@@ -1,2776 +0,0 @@
-# loopwind - Complete Documentation for LLMs
-
-This is a comprehensive, single-file documentation for loopwind, optimized for LLM consumption.
-Generated: 2025-11-20T11:24:11.500Z
-
----
-
-
-
-================================================================================
-FILE: index.mdx
-================================================================================
-
-import CodeVideoDemo from '../components/CodeVideoDemo.astro';
-
-export const videoCode = `// _loopwind/templates/video-intro.tsx
-export const meta = {
-  name: 'video-intro',
-  type: 'video',
-  size: { width: 1200, height: 676 },
-  video: { fps: 30, duration: 3 },
-  props: {
-    title: 'string',
-    subtitle: 'string'
-  }
-};
-
-export default function VideoIntro({ tw, title, subtitle }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gradient-to-br from-blue-600 to-purple-700 gap-4')}>
-      <div style={tw('relative flex flex-row items-center gap-2 ease-out')}>
-        {/* loop-ping/500: scale up + fade out every 500ms (radar effect) */}
-        <div style={tw('w-3 h-3 bg-white rounded-full loop-ping/500')} />
-        <div style={tw('text-white')}>Label</div>
-      </div>
-      {/* enter-fade-in/0/1200: fade in starting at 0ms, lasting 1200ms */}
-      <h1 style={tw('text-7xl font-bold text-white enter-fade-in/0/1200')}>
-        {title}
-      </h1>
-      {/* enter-fade-in/300/1200: fade in starting at 300ms, lasting 1200ms */}
-      <p style={tw('text-2xl text-white/80 ease-out enter-fade-in/300/1200')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-`;
-
-export const imageCode = `// _loopwind/templates/og-image.tsx
-export const meta = {
-  name: 'og-image',
-  type: 'image',
-  size: { width: 1200, height: 630 },
-  props: { 
-    title: 'string',
-    description: 'string'
-  }
-};
-
-export default function OGImage({ tw, title, description }) {
-  return (
-    <div style={tw('flex w-full h-full bg-card p-16')}>
-      <div style={tw('flex flex-col justify-between flex-1')}>
-        <div style={tw('text-sm text-muted-foreground')}>
-          loopwind.dev
-        </div>
-        
-        <div>
-          <h1 style={tw('text-6xl font-bold text-foreground mb-6')}>
-            {title}
-          </h1>
-          <p style={tw('text-2xl text-muted-foreground')}>
-            {description}
-          </p>
-        </div>
-
-        <div style={tw('flex items-center gap-3')}>
-          <span style={tw('text-5xl')}>↫</span>
-          <span style={tw('text-3xl font-semibold bg-linear-to-r from-brand-from to-brand-to bg-clip-text text-transparent')}>
-            loopwind
-          </span>
-        </div>
-      </div>
-    </div>
-  );
-}
-`;
-
-## Generate Images and Videos with Code
-
-Write React components, render them as images or videos. No design tools needed.
-
-<CodeVideoDemo 
-  code={videoCode}
-  videoSrc="/demo-intro.mp4"
-  title="Video Templates"
-/>
-
-**Render it in one command:**
-
-```bash
-loopwind render video-intro '{"title":"Welcome!","subtitle":"Built with loopwind"}'
-```
-
-**Perfect for:** Social media intros, animated logos, product demos, tutorial overlays.
-
----
-
-## Image Templates
-
-Generate Open Graph images, Twitter cards, and more:
-
-```tsx
-{imageCode}
-```
-
-**Render it:**
-
-```bash
-loopwind render og-image '{"title":"Hello World","description":"My awesome post"}'
-```
-
-**Output:** `_loopwind/outputs/og-image.png` (1200×630px)
-
----
-
-## Why loopwind?
-
-### 🎨 Beautiful by Default
-
-Built on shadcn/ui design system with semantic colors (`text-primary`, `bg-card`) and Tailwind CSS utilities. Your templates look professional out of the box.
-
-### ⚡ Blazing Fast Rendering
-
-- **Serverless-ready**: Pure JavaScript rendering with Satori - works on Vercel, Netlify, Cloudflare Workers
-- **WASM-powered video**: MP4 encoding that's 12x faster than traditional approaches
-- **No dependencies**: No FFmpeg, no Chrome, no Docker. Just JavaScript.
-
-### 📦 Template Marketplace (coming soon)
-
-Install templates like UI components. Browse, add, and customize in seconds:
-
-```bash
-loopwind add banner-hero
-loopwind add video-intro
-loopwind add product-card
-```
-
-### 🤖 Built for AI Agents
-
-Machine-readable metadata and simple CLI make it perfect for automation:
-
-```bash
-# Generate social media content programmatically
-loopwind render og-image '{"title":"'$TITLE'","description":"'$DESC'"}'
-```
-
-### 🚀 Framework Agnostic
-
-Works everywhere: Node.js, Bun, Deno, Python, PHP, Go. If it can run a CLI command, it can use loopwind.
-
----
-
-## Key Features
-
-- ✨ **Template-based workflow** - Install and customize design templates
-- 🎬 **Animation classes** - `enter-fade-in/0/500`, `loop-spin/1000` - no manual calculations
-- 📱 **Built-in helpers** - QR codes, image embedding, video backgrounds, template composition
-- ✅ **Smart validation** - Automatic prop and template validation with helpful errors
-- 🎨 **Full Tailwind support** - Including opacity modifiers (`bg-primary/50`)
-- 🔧 **Zero config** - Works out of the box, customize when you need to
-- 📝 **Type-safe** - Full TypeScript support with prop validation
-- 🌐 **Edge-ready** - Runs anywhere JavaScript runs
-
----
-
-## Use Cases
-
-**Marketing Automation**
-- Generate personalized email headers
-- Create dynamic social media posts
-- Automate Open Graph images
-
-**Content Creation**
-- Produce video intros and outros
-- Generate thumbnail variations
-- Create branded graphics at scale
-
-**Developer Tools**
-- Build dynamic README badges
-- Generate documentation images
-- Create automated reports
-
-**E-commerce**
-- Product card generation
-- Sale announcement videos
-- Dynamic pricing graphics
-
----
-
-## Get Started
-
-```bash
-npm install -g loopwind
-loopwind init
-loopwind add video-intro
-loopwind render video-intro '{"title":"Hello World"}'
-```
-
-[View Full Documentation](/getting-started) · [Browse Templates](/templates) · [See Examples](/images)
-
----
-
-## Learn More
-
-- [Getting Started Guide](/getting-started) - Installation and first steps
-- [Templates](/templates) - Create and customize templates
-- [Images](/images) - Static image generation
-- [Video](/video) - Animated video rendering
-- [Styling](/styling) - Tailwind & shadcn/ui integration
-- [SDK](/sdk) - Programmatic usage
-- [AI Agents](/agents) - Integration guide for LLMs
-
-
-
-
-
-================================================================================
-FILE: templates.mdx
-================================================================================
-
-# Installing Templates
-
-## Overview
-loopwind supports installing templates from multiple sources:
-
-1. **Official templates**
-2. **Direct URLs**
-
-## 1. Default templates
-
-```bash
-loopwind add image-template
-loopwind add video-template
-```
-
-## 2. Direct URLs
-Install a template from any publicly accessible URL:
-
-```bash
-loopwind add https://example.com/templates/my-template.json
-loopwind add https://cdn.example.com/templates/awesome-banner.json
-```
-
-**Requirements:**
-- URL must return JSON in the registry template format
-- Must be publicly accessible (no authentication)
-
-**Example template JSON:**
-
-```json
-{
-  "name": "my-template",
-  "version": "1.0.0",
-  "description": "My custom template",
-  "files": [
-    {
-      "path": "template.tsx",
-      "content": "export const meta = {...};\n\nexport default function..."
-    }
-  ]
-}
-```
-
-## 3. Local Filesystem
-
-Install templates from your local filesystem:
-
-```bash
-# Relative path
-loopwind add ./my-templates/banner-hero
-loopwind add ../shared-templates/product-card
-
-# Absolute path
-loopwind add /Users/you/templates/social-card
-```
-
-**Use cases:**
-- Development and testing
-- Private templates
-- Shared team templates (monorepo)
-- Before publishing to registry
-
-## Template Installation Directory
-
-Templates are installed to `_loopwind/templates/<template-name>/` by default.
-
-Customize this in `_loopwind/loopwind.json`:
-
-```json title="_loopwind/loopwind.json"
-{
-  "templatesDir": "my-custom-templates"
-}
-```
-
-## Benefits of Local Installation
-
-- **Version Control**: Templates are part of your project
-- **Offline**: Works without internet once installed
-- **Team Sharing**: Everyone on the team has the same templates
-- **Customization**: Fork and modify templates per project
-- **Consistency**: Different projects can use different template versions
-
-## Next Steps
-
-- [Learn about Helpers](/helpers)
-- [Styling with Tailwind & shadcn/ui](/styling)
-- [Custom Fonts](/fonts)
-- [Image Rendering](/images)
-- [Video Rendering](/video)
-
-
-
-
-
-================================================================================
-FILE: images.mdx
-================================================================================
-
-# Image Rendering
-
-Generate beautiful images from React components using loopwind's powerful image rendering engine powered by Satori.
-
-## Quick Start
-
-```bash
-# Render an image template with inline props
-loopwind render banner-hero '{"title":"Hello World","subtitle":"Welcome"}'
-
-# Custom output name
-loopwind render banner-hero '{"title":"Hello"}' --out custom-name.png
-
-# Different format
-loopwind render banner-hero '{"title":"Hello"}' --format jpeg --quality 95
-
-# Or use a props file
-loopwind render banner-hero props.json
-```
-
-## Image Template Structure
-
-### Basic Template
-
-```tsx
-// banner-hero.tsx
-export const meta = {
-  name: "banner-hero",
-  type: "image",
-  description: "Hero banner with gradient background",
-  size: { width: 1600, height: 900 },
-  props: { title: "string", subtitle: "string" }
-};
-
-export default function BannerHero({ title, subtitle, tw }) {
-  return (
-    <div style={tw('flex flex-col justify-center items-center w-full h-full bg-gradient-to-br from-purple-600 to-blue-500 p-12')}>
-      <h1 style={tw('text-7xl font-bold text-white mb-4')}>
-        {title}
-      </h1>
-      <p style={tw('text-2xl text-white/80')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-```
-
-### Props File
-
-```json
-{
-  "title": "Welcome to loopwind",
-  "subtitle": "Generate beautiful images from React"
-}
-```
-
-## Output Formats
-
-### PNG (Default)
-
-```bash
-loopwind render my-template '{"title":"Hello"}'
-# Output: _loopwind/outputs/my-template.png
-```
-
-**Best for:**
-- Designs with transparency
-- High-quality graphics
-- Sharp text and logos
-- Web graphics
-
-### JPEG
-
-```bash
-loopwind render my-template '{"title":"Hello"}' --format jpeg --quality 92
-```
-
-**Options:**
-- `--quality` - 1-100 (default: 92)
-
-**Best for:**
-- Photographs
-- Gradients
-- Smaller file sizes
-- Social media images
-
-### SVG
-
-```bash
-loopwind render my-template '{"title":"Hello"}' --format svg
-```
-
-**Best for:**
-- Vector graphics
-- Scalable designs
-- Print-ready artwork
-- Logos and icons
-
-## Embedding Images
-
-Use the `image()` helper to embed images in your templates. It supports two modes:
-
-1. **Prop-based** - Load from a prop value: `image('logo')`
-2. **Direct file** - Load from template directory: `image('icon.svg')`
-
-### Prop-based Images
-
-Pass the prop name to load an image path from props:
-
-```tsx
-export default function ProductCard({ tw, image, title, background }) {
-  return (
-    <div style={tw('relative w-full h-full')}>
-      {/* Load image from 'background' prop */}
-      <img
-        src={image('background')}
-        style={tw('absolute inset-0 w-full h-full object-cover')}
-      />
-
-      {/* Content overlay */}
-      <div style={tw('relative z-10 p-12')}>
-        <h1 style={tw('text-6xl font-bold text-white')}>{title}</h1>
-      </div>
-    </div>
-  );
-}
-```
-
-**Props:**
-```json
-{
-  "title": "New Product",
-  "background": "./images/background.jpg"
-}
-```
-
-### Direct File Images
-
-Load images directly from your template directory by including the file extension:
-
-```tsx
-export default function ChangelogItem({ tw, image, text }) {
-  return (
-    <div style={tw('flex items-center gap-4')}>
-      {/* Load check.svg from template directory */}
-      <img
-        src={image('check.svg')}
-        style={tw('w-6 h-6')}
-      />
-      <span style={tw('text-lg')}>{text}</span>
-    </div>
-  );
-}
-```
-
-This loads `check.svg` from the same directory as your template file. You can also use subdirectories:
-
-```tsx
-// Load from assets subdirectory
-<img src={image('assets/icons/star.svg')} />
-
-// Load from shared folder
-<img src={image('shared/logo.png')} />
-```
-
-**Template directory structure:**
-```
-_loopwind/templates/my-template/
-├── template.tsx
-├── check.svg           ← image('check.svg')
-└── assets/
-    └── icons/
-        └── star.svg    ← image('assets/icons/star.svg')
-```
-
-### URLs
-
-The `image()` helper also supports loading images from URLs:
-
-```json
-{
-  "background": "https://example.com/image.jpg"
-}
-```
-
-### Supported Image Formats
-
-- ✅ **JPEG** (`.jpg`, `.jpeg`)
-- ✅ **PNG** (`.png`)
-- ✅ **GIF** (`.gif`)
-- ✅ **WebP** (`.webp`)
-- ✅ **SVG** (`.svg`)
-
-### Image Positioning
-
-```tsx
-export default function ImageGrid({ tw, image, img1, img2, img3 }) {
-  return (
-    <div style={tw('grid grid-cols-3 gap-4 w-full h-full p-8 bg-gray-100')}>
-      {/* Cover - fills entire area */}
-      <img 
-        src={image(img1)} 
-        style={tw('w-full h-full object-cover rounded-lg')}
-      />
-      
-      {/* Contain - fits within area */}
-      <img 
-        src={image(img2)} 
-        style={tw('w-full h-full object-contain')}
-      />
-      
-      {/* Fill - stretches to fill */}
-      <img 
-        src={image(img3)} 
-        style={tw('w-full h-full object-fill')}
-      />
-    </div>
-  );
-}
-```
-
-## Common Image Templates
-
-### Open Graph / Social Cards
-
-```tsx
-// og-image.tsx
-export default function OGImage({ tw, title, description, image, logo }) {
-  return (
-    <div style={tw('flex w-full h-full bg-white')}>
-      {/* Left side - Content */}
-      <div style={tw('flex-1 flex flex-col justify-between p-12')}>
-        <img src={image(logo)} style={tw('h-12 w-auto')} />
-        
-        <div>
-          <h1 style={tw('text-5xl font-bold text-gray-900 mb-4')}>
-            {title}
-          </h1>
-          <p style={tw('text-xl text-gray-600')}>
-            {description}
-          </p>
-        </div>
-        
-        <p style={tw('text-gray-400')}>yoursite.com</p>
-      </div>
-      
-      {/* Right side - Image */}
-      <div style={tw('flex-1')}>
-        <img 
-          src={image(featuredImage)} 
-          style={tw('w-full h-full object-cover')}
-        />
-      </div>
-    </div>
-  );
-}
-```
-
-**Size:** 1200x630 (standard OG image size)
-
-### Product Cards
-
-```tsx
-export default function ProductCard({ tw, image, product, price, badge }) {
-  return (
-    <div style={tw('flex flex-col w-full h-full bg-white rounded-2xl overflow-hidden')}>
-      {/* Product image */}
-      <div style={tw('relative h-2/3')}>
-        <img 
-          src={image(product)} 
-          style={tw('w-full h-full object-cover')}
-        />
-        {badge && (
-          <div style={tw('absolute top-4 right-4 bg-red-500 text-white px-4 py-2 rounded-full text-sm font-bold')}>
-            {badge}
-          </div>
-        )}
-      </div>
-      
-      {/* Product info */}
-      <div style={tw('flex-1 p-6 flex flex-col justify-between')}>
-        <h2 style={tw('text-2xl font-bold text-gray-900')}>
-          {title}
-        </h2>
-        <div style={tw('flex justify-between items-center')}>
-          <span style={tw('text-3xl font-bold text-gray-900')}>
-            ${price}
-          </span>
-        </div>
-      </div>
-    </div>
-  );
-}
-```
-
-### Quote Cards
-
-```tsx
-export default function QuoteCard({ tw, image, quote, author, avatar }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gradient-to-br from-indigo-500 to-purple-600 p-16')}>
-      {avatar && (
-        <img 
-          src={image(avatar)} 
-          style={tw('w-24 h-24 rounded-full border-4 border-white mb-8')}
-        />
-      )}
-      
-      <blockquote style={tw('text-3xl text-white text-center font-light mb-8 max-w-3xl')}>
-        "{quote}"
-      </blockquote>
-      
-      <p style={tw('text-xl text-white/80')}>
-        — {author}
-      </p>
-    </div>
-  );
-}
-```
-
-## Performance Tips
-
-### 1. Optimize Image Sizes
-
-Use appropriately sized images before embedding:
-
-```bash
-# Resize large images before using them
-convert large-image.jpg -resize 1600x900 optimized.jpg
-```
-
-### 2. Use Web-Optimized Formats
-
-- **WebP** for modern browsers (smaller file sizes)
-- **JPEG** for photos with controlled quality
-- **PNG** only when transparency is needed
-
-### 3. Batch Rendering
-
-Render multiple images at once:
-
-```bash
-# Using a script with inline props
-loopwind render my-template '{"title":"Image 1"}'
-loopwind render my-template '{"title":"Image 2"}'
-loopwind render my-template '{"title":"Image 3"}'
-
-# Or loop through props files
-for props in props/*.json; do
-  loopwind render my-template "$props"
-done
-```
-
-### 4. Cache Templates
-
-Templates are cached after first load for faster subsequent renders.
-
-## Common Sizes
-
-### Social Media
-
-- **Twitter/X Card**: 1200x675
-- **Facebook Post**: 1200x630
-- **Instagram Post**: 1080x1080
-- **LinkedIn Post**: 1200x627
-- **Pinterest Pin**: 1000x1500
-
-### Web Graphics
-
-- **Hero Banner**: 1920x1080
-- **Blog Header**: 1600x900
-- **Thumbnail**: 640x360
-- **Avatar**: 400x400
-
-### Print
-
-- **Flyer (A4)**: 2480x3508 (300 DPI)
-- **Business Card**: 1050x600 (300 DPI)
-- **Poster (A3)**: 3508x4961 (300 DPI)
-
-## Troubleshooting
-
-### Images Not Loading
-
-Check file paths are relative to the props file:
-
-```json
-{
-  "background": "./images/bg.jpg"  // ✅ Relative path
-  "background": "/images/bg.jpg"   // ❌ Absolute path won't work
-}
-```
-
-### Blurry Text
-
-Ensure you're using appropriate dimensions. Satori renders at exact pixel dimensions.
-
-## Next Steps
-
-- [Learn about Video Rendering](/video)
-- [QR Codes and Template Composition](/helpers)
-- [Styling with Tailwind & shadcn/ui](/styling)
-- [Using Custom Fonts](/fonts)
-
-
-
-
-
-================================================================================
-FILE: video.mdx
-================================================================================
-
-# Video Rendering
-
-Create animated videos programmatically using React components. Perfect for automated video generation, social media content, and dynamic animations.
-
-## Quick Start
-
-```bash
-# Render a video template with inline props
-loopwind render video-intro '{"title":"Welcome!"}' --out intro.mp4
-
-# With custom encoding
-loopwind render video-intro '{"title":"Welcome!"}' --preset ultrafast
-
-# Or use a props file
-loopwind render video-intro props.json --out intro.mp4
-```
-
-## Video Template Structure
-
-### Basic Template
-
-```tsx
-// video-intro.tsx
-export const meta = {
-  name: "video-intro",
-  type: "video",
-  description: "Animated intro with bounce-in title",
-  size: { width: 1920, height: 1080 },
-  video: { fps: 30, duration: 3 },
-  props: { title: "string" }
-};
-
-export default function VideoIntro({ tw, title }) {
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-gradient-to-br from-blue-600 to-purple-700')}>
-      {/* Bounce in from below at start */}
-      <h1 style={tw('text-8xl font-bold text-white ease-out enter-bounce-in-up/0/600')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-### Props File
-
-```json
-{
-  "title": "Welcome!"
-}
-```
-
-## Animation
-
-loopwind provides **Tailwind-style animation classes** for creating smooth video animations without writing custom code.
-
-Use declarative animation classes with millisecond-based timing:
-
-```tsx
-export default function AnimatedIntro({ tw, title, subtitle }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gradient-to-br from-blue-600 to-purple-700')}>
-      {/* Bounce in from below: starts at 0ms, lasts 400ms */}
-      <h1 style={tw('text-8xl font-bold text-white ease-out enter-bounce-in-up/0/400')}>
-        {title}
-      </h1>
-
-      {/* Fade in with upward motion: starts at 300ms, lasts 400ms */}
-      <p style={tw('text-2xl text-white/80 mt-4 ease-out enter-fade-in-up/300/400')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-```
-
-### Common Animation Patterns
-
-```tsx
-// Fade animations
-<div style={tw('enter-fade-in/0/500')}>Fade in</div>
-<div style={tw('enter-fade-in-up/0/600')}>Fade in with slide</div>
-
-// Slide animations
-<div style={tw('enter-slide-left/0/500')}>Slide from left</div>
-<div style={tw('exit-slide-up/2500/500')}>Slide out up</div>
-
-// Bounce and scale
-<div style={tw('enter-bounce-in/0/500')}>Bouncy entrance</div>
-<div style={tw('enter-scale-in/0/400')}>Scale up</div>
-
-// Loop animations (continuous)
-<div style={tw('loop-float/1000')}>Continuous floating</div>
-<div style={tw('loop-pulse/800')}>Pulsing effect</div>
-```
-
-### Utility-Based Animations
-
-Animate any transform or opacity property directly:
-
-```tsx
-// Translate, rotate, scale
-<div style={tw('enter-translate-x-5/0/500')}>Slide 20px from left</div>
-<div style={tw('enter-rotate-90/0/800')}>Rotate 90 degrees</div>
-<div style={tw('enter-scale-100/0/500')}>Scale from 0 to 100%</div>
-
-// Combine multiple animations
-<div style={tw('enter-translate-y-10/0/500 enter-rotate-45/0/500')}>
-  Fly and spin
-</div>
-```
-
-**See the full [Animation documentation](/animation)** for all animation classes, easing functions, staggered animations, and advanced patterns.
-
-### Programmatic Animations
-
-For complex custom animations, use the `progress` prop directly:
-
-```tsx
-export default function CustomAnimation({ progress, title, tw }) {
-  const opacity = progress < 0.3 ? progress / 0.3 : 1;
-  const scale = 0.8 + (progress * 0.2);
-  
-  return (
-    <h1 style={{
-      ...tw('text-8xl font-bold text-white'),
-      opacity,
-      transform: `scale(${scale})`
-    }}>
-      {title}
-    </h1>
-  );
-}
-```
-
-Most use cases are better served by animation classes, but `progress` and `frame` props give you complete control when needed.
-
-## FPS and Duration
-
-### Common Frame Rates
-
-```tsx
-// Film standard
-export const meta = {
-  // ...
-  video: { fps: 24, duration: 5 }
-};
-```
-
-```tsx
-// YouTube/web standard
-export const meta = {
-  // ...
-  video: { fps: 30, duration: 3 }
-};
-```
-
-```tsx
-// Smooth animations
-export const meta = {
-  // ...
-  video: { fps: 60, duration: 2 }
-};
-```
-
-**Total frames = fps × duration**
-- 24fps × 5s = 120 frames
-- 30fps × 3s = 90 frames
-- 60fps × 2s = 120 frames
-
-### Choosing FPS
-
-- **24fps**: Cinematic look, smaller files
-- **30fps**: Standard web video, good balance
-- **60fps**: Smooth animations, larger files
-
-## Encoding Options
-
-### Default (Balanced)
-
-```bash
-loopwind render video-intro '{"title":"Welcome"}'
-```
-
-Uses H.264 codec with good quality/size balance.
-
-### Fast Encoding
-
-```bash
-loopwind render video-intro '{"title":"Welcome"}' --preset ultrafast
-```
-
-Faster encoding, slightly larger files. Good for previews.
-
-### High Quality
-
-```bash
-loopwind render video-intro '{"title":"Welcome"}' --preset slow
-```
-
-Better compression, slower encoding. Good for final output.
-
-## Performance
-
-### Rendering Speed
-
-On an M1 Mac:
-- **30fps, 3s video** (90 frames): ~15-20 seconds
-- **60fps, 3s video** (180 frames): ~30-40 seconds
-
-Speed depends on:
-- Template complexity
-- Image/video embedding
-- CPU performance
-- Frame count
-
-### Optimization Tips
-
-1. **Lower FPS for previews**: Test at 15fps, render final at 30fps
-2. **Shorter duration**: Preview with 1s, expand for final
-3. **Simplify templates**: Complex layouts take longer
-4. **Pre-optimize media**: Resize images/videos before embedding
-
-### Memory Usage
-
-Video frames are cached in memory during rendering:
-- **1920x1080 @ 30fps for 3s**: ~500MB RAM
-- **1920x1080 @ 60fps for 5s**: ~1.7GB RAM
-
-For long videos, consider rendering in segments.
-
-## Common Video Templates
-
-### Loading Spinner
-
-```tsx
-export default function LoadingVideo({ tw, title }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gray-900')}>
-      {/* Spinner fades out at 60% (1800ms for 3s video) */}
-      <div style={tw('exit-fade-out/1800/400')}>
-        <div style={tw('w-32 h-32 border-8 border-blue-500 border-t-transparent rounded-full loop-spin/1000')} />
-      </div>
-      
-      {/* Title fades in after spinner */}
-      <h1 style={tw('text-6xl font-bold text-white mt-12 ease-out enter-fade-in-up/1800/400')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-### Progress Bar
-
-```tsx
-export default function ProgressVideo({ tw, title, subtitle }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gray-900 p-12')}>
-      {/* Title bounces in */}
-      <h2 style={tw('text-5xl font-bold text-white mb-12 ease-out enter-bounce-in/0/500')}>
-        {title}
-      </h2>
-      
-      {/* Progress bar container fades in */}
-      <div style={tw('w-full max-w-2xl h-4 bg-gray-700 rounded-full overflow-hidden ease-out enter-fade-in/300/400')}>
-        <div style={tw('h-full bg-gradient-to-r from-blue-500 to-green-500 w-full')} />
-      </div>
-      
-      {/* Subtitle fades in last */}
-      <p style={tw('text-2xl text-gray-400 mt-8 ease-out enter-fade-in/600/400')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-```
-
-### Countdown Timer
-
-```tsx
-export default function CountdownVideo({ tw, frame, message }) {
-  const fps = 30;
-  const secondsRemaining = Math.ceil((90 - frame) / fps); // 3s countdown
-  
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-black')}>
-      {/* Number scales in and pulses continuously */}
-      <div style={tw('text-[200px] font-black text-white ease-out enter-scale-in/0/400 loop-pulse/1000')}>
-        {secondsRemaining}
-      </div>
-      
-      {/* Message fades in */}
-      <p style={tw('text-3xl text-gray-400 mt-8 ease-out enter-fade-in/400/500')}>
-        {message}
-      </p>
-    </div>
-  );
-}
-```
-
-## Output Formats
-
-Videos can be rendered in two formats:
-
-### MP4 (Default)
-
-```bash
-# MP4 - H.264 codec, smaller file size, best quality
-loopwind render video-intro '{"title":"Welcome"}' --out intro.mp4
-
-# With custom quality (lower CRF = better quality)
-loopwind render video-intro '{"title":"Welcome"}' --crf 18
-```
-
-**Benefits:**
-- Smaller file sizes
-- Better color reproduction
-- Universal playback support
-- Best for social media, websites
-
-### GIF
-
-```bash
-# GIF - animated, works everywhere
-loopwind render video-intro '{"title":"Welcome"}' --format gif --out intro.gif
-
-# Or just use .gif extension
-loopwind render video-intro '{"title":"Welcome"}' --out intro.gif
-```
-
-**Benefits:**
-- Works in emails, GitHub READMEs, Slack
-- No video player needed
-- Auto-loops by default
-- Great for short animations
-
-**Limitations:**
-- Limited to 256 colors per frame
-- Larger file sizes than MP4
-- Some color banding with gradients
-
-**When to use GIF:**
-- Short loops (< 5 seconds)
-- Simple animations with solid colors
-- Platforms that don't support video (email, GitHub)
-
-**When to use MP4:**
-- Longer videos
-- Complex gradients or photos
-- Best quality and smallest size
-
-## Video-Specific Props
-
-Every video template receives these additional props:
-
-### `frame`
-Current frame number (0 to totalFrames - 1)
-
-```tsx
-export default function MyVideo({ frame }) {
-  // Frame 0, 1, 2, 3, ... 89 (for 3s @ 30fps)
-  return <div>Frame: {frame}</div>;
-}
-```
-
-### `progress`
-Animation progress from 0 to 1
-
-```tsx
-export default function MyVideo({ progress }) {
-  // 0.0 at start, 0.5 at middle, 1.0 at end
-  const x = progress * 100; // Move from 0 to 100
-  
-  return (
-    <div style={{ transform: `translateX(${x}px)` }}>
-      Moving element
-    </div>
-  );
-}
-```
-
-## Next Steps
-
-- [Animation - Complete animation guide](/animation)
-- [Image Rendering](/images)
-- [Helpers - QR Codes and Template Composition](/helpers)
-- [Styling with Tailwind & shadcn/ui](/styling)
-- [Custom Fonts in Videos](/fonts)
-
-
-
-
-
-================================================================================
-FILE: animation.mdx
-================================================================================
-
-# Animation
-
-loopwind provides **Tailwind-style animation classes** that work with time to create smooth video animations without writing custom code.
-
-> **Note:** Animation classes only work with **video templates** and **GIFs**. For static images, animations will have no effect since there's no time context.
-
-## Quick Start
-
-```tsx
-export default function MyVideo({ tw, title, subtitle }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-black')}>
-      {/* Bounce in from below: starts at 0, lasts 400ms */}
-      <h1 style={tw('text-8xl font-bold text-white ease-out enter-bounce-in-up/0/400')}>
-        {title}
-      </h1>
-
-      {/* Fade in with upward motion: starts at 300ms, lasts 400ms */}
-      <p style={tw('text-2xl text-white/80 mt-4 ease-out enter-fade-in-up/300/400')}>
-        {subtitle}
-      </p>
-
-      {/* Continuous floating animation: repeats every 1s (1000ms) */}
-      <div style={tw('mt-8 text-4xl loop-float/1000')}>
-        ⬇️
-      </div>
-    </div>
-  );
-}
-```
-
-## Animation Format
-
-loopwind uses three types of animations with **millisecond timing**:
-
-| Type | Format | Description |
-|------|--------|-------------|
-| Enter | `enter-{type}/{start}/{duration}` | Animations that play when entering |
-| Exit | `exit-{type}/{start}/{duration}` | Animations that play when exiting |
-| Loop | `loop-{type}/{duration}` | Continuous looping animations |
-
-All timing values are in **milliseconds** (1000ms = 1 second).
-
-## Utility-Based Animations
-
-In addition to predefined animations, loopwind supports **Tailwind utility-based animations** that let you animate any transform or opacity property directly:
-
-```tsx
-// Slide in 20px from the left
-<div style={tw('enter-translate-x-5/0/1000')}>Content</div>
-
-// Rotate 90 degrees on entrance
-<div style={tw('enter-rotate-90/0/500')}>Spinning</div>
-
-// Fade to 50% opacity in a loop
-<div style={tw('loop-opacity-50/1000')}>Pulsing</div>
-
-// Scale down with negative value
-<div style={tw('enter--scale-50/0/800')}>Shrinking</div>
-```
-
-### Supported Utilities
-
-| Utility | Format | Description | Example |
-|---------|--------|-------------|---------|
-| **translate-x** | `enter-translate-x-{value}` | Translate horizontally | `enter-translate-x-5` = 20px<br/>`enter-translate-x-full` = 100%<br/>`enter-translate-x-[20px]` = 20px |
-| **translate-y** | `enter-translate-y-{value}` | Translate vertically | `loop-translate-y-10` = 40px<br/>`enter-translate-y-1/2` = 50%<br/>`enter-translate-y-[5rem]` = 80px |
-| **opacity** | `enter-opacity-{n}` | Set opacity (0-100) | `enter-opacity-50` = 50% |
-| **scale** | `enter-scale-{n}` | Scale element (0-200) | `enter-scale-100` = 1.0x |
-| **rotate** | `enter-rotate-{n}` | Rotate in degrees | `enter-rotate-45` = 45° |
-| **skew-x** | `enter-skew-x-{n}` | Skew on X axis in degrees | `enter-skew-x-12` = 12° |
-| **skew-y** | `enter-skew-y-{n}` | Skew on Y axis in degrees | `exit-skew-y-6` = 6° |
-
-**Translate value formats:**
-- **Numeric**: `5` = 20px (Tailwind spacing scale: 1 unit = 4px)
-- **Keywords**: `full` = 100%
-- **Fractions**: `1/2` = 50%, `1/3` = 33.333%, `2/3` = 66.666%, etc.
-- **Arbitrary values**: `[20px]`, `[5rem]`, `[10%]` (rem converts to px: 1rem = 16px)
-
-All utilities work with:
-- **All prefixes**: `enter-`, `exit-`, `loop-`, `animate-`
-- **Negative values**: Prefix with `-` (e.g., `-translate-x-5`, `-rotate-45`)
-- **Timing syntax**: Add `/start/duration` (e.g., `enter-translate-x-5/0/800`)
-
-### Translate Animations
-
-```tsx
-// Numeric (Tailwind spacing): 20px (5 * 4px)
-<div style={tw('enter-translate-x-5/0/500')}>Content</div>
-
-// Keyword: Full width (100%)
-<div style={tw('enter-translate-y-full/0/800')}>Dropping full height</div>
-
-// Fraction: Half width (50%)
-<div style={tw('enter-translate-x-1/2/0/600')}>Slide in halfway</div>
-
-// Arbitrary values: Exact px or rem
-<div style={tw('enter-translate-y-[20px]/0/500')}>Slide 20px</div>
-<div style={tw('enter-translate-x-[5rem]/0/800')}>Slide 5rem (80px)</div>
-
-// Loop with fractions
-<div style={tw('loop-translate-y-1/4/1000')}>Oscillate 25%</div>
-
-// Negative values
-<div style={tw('exit--translate-y-8/2000/500')}>Rising</div>
-```
-
-### Opacity Animations
-
-```tsx
-// Fade to 100% opacity
-<div style={tw('enter-opacity-100/0/500')}>Fading In</div>
-
-// Fade to 50% opacity
-<div style={tw('enter-opacity-50/0/800')}>Half Opacity</div>
-
-// Pulse between 50% and 100%
-<div style={tw('loop-opacity-50/1000')}>Pulsing</div>
-
-// Fade out to 0%
-<div style={tw('exit-opacity-0/2500/500')}>Vanishing</div>
-```
-
-### Scale Animations
-
-```tsx
-// Scale from 0 to 100% (1.0x)
-<div style={tw('enter-scale-100/0/500')}>Growing</div>
-
-// Scale to 150% (1.5x)
-<div style={tw('enter-scale-150/0/800')}>Enlarging</div>
-
-// Pulse scale in a loop
-<div style={tw('loop-scale-110/1000')}>Breathing</div>
-
-// Scale down to 50%
-<div style={tw('exit-scale-50/2000/500')}>Shrinking</div>
-```
-
-### Rotate Animations
-
-```tsx
-// Rotate 90 degrees
-<div style={tw('enter-rotate-90/0/500')}>Quarter Turn</div>
-
-// Rotate 180 degrees
-<div style={tw('enter-rotate-180/0/1000')}>Half Turn</div>
-
-// Continuous rotation in loop (360 degrees per cycle)
-<div style={tw('loop-rotate-360/2000')}>Spinning</div>
-
-// Rotate backwards with negative value
-<div style={tw('enter--rotate-45/0/500')}>Counter Rotation</div>
-```
-
-### Skew Animations
-
-```tsx
-// Skew on X axis
-<div style={tw('enter-skew-x-12/0/500')}>Slanted</div>
-
-// Skew on Y axis
-<div style={tw('enter-skew-y-6/0/800')}>Tilted</div>
-
-// Oscillating skew in loop
-<div style={tw('loop-skew-x-6/1000')}>Wobbling</div>
-
-// Negative skew
-<div style={tw('exit--skew-x-12/2000/500')}>Reverse Slant</div>
-```
-
-### Combining Utilities
-
-You can combine multiple utility animations on the same element:
-
-```tsx
-// Translate and rotate together
-<div style={tw('enter-translate-y-10/0/500 enter-rotate-45/0/500')}>
-  Flying In
-</div>
-
-// Fade and scale
-<div style={tw('enter-opacity-100/0/800 enter-scale-100/0/800')}>
-  Appearing
-</div>
-
-// Enter with translate, exit with rotation
-<div style={tw('enter-translate-x-5/0/500 exit-rotate-180/2500/500')}>
-  Slide and Spin
-</div>
-```
-
-### Bracket Notation
-
-For more CSS-like syntax, you can use brackets with units:
-
-```tsx
-// Using bracket notation with seconds
-<h1 style={tw('enter-slide-up/[0.6s]/[1.5s]')}>Hello</h1>
-
-// Using bracket notation with milliseconds
-<h1 style={tw('enter-fade-in/[300ms]/[800ms]')}>World</h1>
-
-// Mix and match - plain numbers are milliseconds
-<h1 style={tw('enter-bounce-in/0/[1.2s]')}>Mixed</h1>
-```
-
-## Enter Animations
-
-Format: `enter-{type}/{startMs}/{durationMs}`
-
-- `startMs` - when the animation begins (milliseconds from start)
-- `durationMs` - how long the animation lasts
-
-When values are omitted (`enter-fade-in`), it uses the full video duration.
-
-### Fade Animations
-
-Simple opacity transitions with optional direction.
-
-```tsx
-// Fade in from 0ms to 500ms
-<h1 style={tw('enter-fade-in/0/500')}>Hello</h1>
-
-// Fade in with upward motion
-<h1 style={tw('enter-fade-in-up/0/600')}>Hello</h1>
-```
-
-| Class | Description |
-|-------|-------------|
-| `enter-fade-in/0/500` | Fade in (opacity 0 → 1) |
-| `enter-fade-in-up/0/500` | Fade in + slide up (30px) |
-| `enter-fade-in-down/0/500` | Fade in + slide down (30px) |
-| `enter-fade-in-left/0/500` | Fade in + slide from left (30px) |
-| `enter-fade-in-right/0/500` | Fade in + slide from right (30px) |
-
-### Slide Animations
-
-Larger movement (100px) with fade.
-
-```tsx
-// Slide in from left: starts at 0, lasts 500ms
-<div style={tw('enter-slide-left/0/500')}>Content</div>
-
-// Slide up from bottom: starts at 200ms, lasts 600ms
-<div style={tw('enter-slide-up/200/600')}>Content</div>
-```
-
-| Class | Description |
-|-------|-------------|
-| `enter-slide-left/0/500` | Slide in from left (100px) |
-| `enter-slide-right/0/500` | Slide in from right (100px) |
-| `enter-slide-up/0/500` | Slide in from bottom (100px) |
-| `enter-slide-down/0/500` | Slide in from top (100px) |
-
-### Bounce Animations
-
-Playful entrance with overshoot effect.
-
-```tsx
-// Bounce in with scale overshoot
-<h1 style={tw('enter-bounce-in/0/500')}>Bouncy!</h1>
-
-// Bounce in from below
-<div style={tw('enter-bounce-in-up/0/600')}>Pop!</div>
-```
-
-| Class | Description |
-|-------|-------------|
-| `enter-bounce-in/0/500` | Bounce in with scale overshoot |
-| `enter-bounce-in-up/0/500` | Bounce in from below |
-| `enter-bounce-in-down/0/500` | Bounce in from above |
-| `enter-bounce-in-left/0/500` | Bounce in from left |
-| `enter-bounce-in-right/0/500` | Bounce in from right |
-
-### Scale & Zoom Animations
-
-Size-based transitions.
-
-```tsx
-// Scale in from 50%
-<div style={tw('enter-scale-in/0/500')}>Growing</div>
-
-// Zoom in from 0%
-<div style={tw('enter-zoom-in/0/1000')}>Zooming</div>
-```
-
-| Class | Description |
-|-------|-------------|
-| `enter-scale-in/0/500` | Scale up from 50% to 100% |
-| `enter-zoom-in/0/500` | Zoom in from 0% to 100% |
-
-### Rotate & Flip Animations
-
-Rotation-based transitions.
-
-```tsx
-// Rotate in 180 degrees
-<div style={tw('enter-rotate-in/0/500')}>Spinning</div>
-
-// 3D flip on X axis
-<div style={tw('enter-flip-in-x/0/500')}>Flipping</div>
-```
-
-| Class | Description |
-|-------|-------------|
-| `enter-rotate-in/0/500` | Rotate in from -180° |
-| `enter-flip-in-x/0/500` | 3D flip on horizontal axis |
-| `enter-flip-in-y/0/500` | 3D flip on vertical axis |
-
-## Exit Animations
-
-Format: `exit-{type}/{startMs}/{durationMs}`
-
-- `startMs` - when the exit animation begins
-- `durationMs` - how long the exit animation lasts
-
-Exit animations use the same timing system but animate elements out.
-
-```tsx
-// Fade out starting at 2500ms, lasting 500ms (ends at 3000ms)
-<h1 style={tw('exit-fade-out/2500/500')}>Goodbye</h1>
-
-// Combined enter and exit on same element
-<h1 style={tw('enter-fade-in/0/500 exit-fade-out/2500/500')}>
-  Hello and Goodbye
-</h1>
-```
-
-| Class | Description |
-|-------|-------------|
-| `exit-fade-out/2500/500` | Fade out (opacity 1 → 0) |
-| `exit-fade-out-up/2500/500` | Fade out + slide up |
-| `exit-fade-out-down/2500/500` | Fade out + slide down |
-| `exit-fade-out-left/2500/500` | Fade out + slide left |
-| `exit-fade-out-right/2500/500` | Fade out + slide right |
-| `exit-slide-up/2500/500` | Slide out upward (100px) |
-| `exit-slide-down/2500/500` | Slide out downward (100px) |
-| `exit-slide-left/2500/500` | Slide out to left (100px) |
-| `exit-slide-right/2500/500` | Slide out to right (100px) |
-| `exit-scale-out/2500/500` | Scale out to 150% |
-| `exit-zoom-out/2500/500` | Zoom out to 200% |
-| `exit-rotate-out/2500/500` | Rotate out to 180° |
-| `exit-bounce-out/2500/500` | Bounce out with scale |
-| `exit-bounce-out-up/2500/500` | Bounce out upward |
-| `exit-bounce-out-down/2500/500` | Bounce out downward |
-| `exit-bounce-out-left/2500/500` | Bounce out to left |
-| `exit-bounce-out-right/2500/500` | Bounce out to right |
-
-## Loop Animations
-
-Format: `loop-{type}/{durationMs}`
-
-Loop animations repeat every `{durationMs}` milliseconds:
-- `/1000` = 1 second loop
-- `/500` = 0.5 second loop
-- `/2000` = 2 second loop
-
-When duration is omitted (`loop-bounce`), it defaults to 1000ms (1 second).
-
-```tsx
-// Pulse opacity every 500ms
-<div style={tw('loop-fade/500')}>Pulsing</div>
-
-// Bounce every 800ms
-<div style={tw('loop-bounce/800')}>Bouncing</div>
-
-// Full rotation every 2000ms
-<div style={tw('loop-spin/2000')}>Spinning</div>
-```
-
-| Class | Description |
-|-------|-------------|
-| `loop-fade/{ms}` | Opacity pulse (0.5 → 1 → 0.5) |
-| `loop-bounce/{ms}` | Bounce up and down |
-| `loop-spin/{ms}` | Full 360° rotation |
-| `loop-ping/{ms}` | Scale up + fade out (radar effect) |
-| `loop-wiggle/{ms}` | Side to side wiggle |
-| `loop-float/{ms}` | Gentle up and down floating |
-| `loop-pulse/{ms}` | Scale pulse (1.0 → 1.05 → 1.0) |
-| `loop-shake/{ms}` | Shake side to side |
-
-## Easing Functions
-
-Add an easing class **before** the animation class to control the timing curve.
-
-```tsx
-// Ease in (accelerate)
-<h1 style={tw('ease-in enter-fade-in/0/1000')}>Accelerating</h1>
-
-// Ease out (decelerate) - default
-<h1 style={tw('ease-out enter-fade-in/0/1000')}>Decelerating</h1>
-
-// Ease in-out (smooth)
-<h1 style={tw('ease-in-out enter-fade-in/0/1000')}>Smooth</h1>
-
-// Strong cubic easing
-<h1 style={tw('ease-out-cubic enter-bounce-in/0/500')}>Dramatic</h1>
-```
-
-| Class | Description | Best For |
-|-------|-------------|----------|
-| `linear` | Constant speed | Mechanical motion |
-| `ease-in` | Slow start, fast end | Exit animations |
-| `ease-out` | Fast start, slow end (default) | Enter animations |
-| `ease-in-out` | Slow start and end | Subtle transitions |
-| `ease-in-cubic` | Strong slow start | Dramatic exits |
-| `ease-out-cubic` | Strong fast start | Impactful entrances |
-| `ease-in-out-cubic` | Strong both ends | Emphasis animations |
-| `ease-in-quart` | Very strong slow start | Powerful exits |
-| `ease-out-quart` | Very strong fast start | Punchy entrances |
-| `ease-in-out-quart` | Very strong both ends | Maximum drama |
-
-## Combining Enter and Exit
-
-You can use both enter and exit animations on the same element:
-
-```tsx
-export default function EnterExit({ tw, title }) {
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-black')}>
-      {/* Fade in during first 500ms, fade out during last 500ms (assuming 3s video) */}
-      <h1 style={tw('text-8xl font-bold text-white enter-fade-in/0/500 exit-fade-out/2500/500')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-The opacities from multiple animations are **multiplied together**, so you get smooth transitions that combine properly.
-
-## Staggered Animations
-
-Create sequenced animations by offsetting start times:
-
-```tsx
-export default function StaggeredList({ tw, items }) {
-  return (
-    <div style={tw('flex flex-col gap-4')}>
-      {/* First item: starts at 0ms, lasts 300ms */}
-      <div style={tw('ease-out enter-fade-in-left/0/300')}>
-        {items[0]}
-      </div>
-
-      {/* Second item: starts at 100ms, lasts 300ms */}
-      <div style={tw('ease-out enter-fade-in-left/100/300')}>
-        {items[1]}
-      </div>
-
-      {/* Third item: starts at 200ms, lasts 300ms */}
-      <div style={tw('ease-out enter-fade-in-left/200/300')}>
-        {items[2]}
-      </div>
-    </div>
-  );
-}
-```
-
-### Dynamic Staggering
-
-For dynamic lists, calculate the timing programmatically:
-
-```tsx
-export default function DynamicStagger({ tw, items }) {
-  return (
-    <div style={tw('flex flex-col gap-4')}>
-      {items.map((item, i) => {
-        const start = i * 100;      // Each item starts 100ms later
-        const duration = 300;       // Each animation lasts 300ms
-
-        return (
-          <div
-            key={i}
-            style={tw(`ease-out enter-fade-in-up/${start}/${duration}`)}
-          >
-            {item}
-          </div>
-        );
-      })}
-    </div>
-  );
-}
-```
-
-## Common Patterns
-
-### Intro Sequence
-
-```tsx
-export default function IntroVideo({ tw, title, subtitle, logo }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-gradient-to-br from-blue-600 to-purple-700')}>
-      {/* Logo appears first */}
-      <img
-        src={logo}
-        style={tw('h-20 mb-8 ease-out enter-scale-in/0/300')}
-      />
-
-      {/* Title bounces in */}
-      <h1 style={tw('text-7xl font-bold text-white ease-out enter-bounce-in-up/200/500')}>
-        {title}
-      </h1>
-
-      {/* Subtitle fades in last */}
-      <p style={tw('text-2xl text-white/80 mt-4 ease-out enter-fade-in-up/400/700')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-```
-
-### Text Reveal
-
-```tsx
-export default function TextReveal({ tw, words }) {
-  return (
-    <div style={tw('flex flex-wrap gap-2 justify-center')}>
-      {words.split(' ').map((word, i) => (
-        <span
-          key={i}
-          style={tw(`text-4xl font-bold ease-out enter-fade-in-up/${i * 100}/200`)}
-        >
-          {word}
-        </span>
-      ))}
-    </div>
-  );
-}
-```
-
-### Looping Background Element
-
-```tsx
-export default function AnimatedBackground({ tw, children }) {
-  return (
-    <div style={tw('relative w-full h-full')}>
-      {/* Floating background circles */}
-      <div style={tw('absolute top-10 left-10 w-20 h-20 rounded-full bg-white/10 loop-float/2000')} />
-      <div style={tw('absolute bottom-20 right-20 w-32 h-32 rounded-full bg-white/10 loop-fade/1500')} />
-
-      {/* Main content */}
-      <div style={tw('relative z-10')}>
-        {children}
-      </div>
-    </div>
-  );
-}
-```
-
-### Full Enter/Exit Animation
-
-```tsx
-export default function FullAnimation({ tw, title }) {
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-black')}>
-      {/* Enter: starts at 0, lasts 400ms. Exit: starts at 2600ms, lasts 400ms */}
-      <h1 style={tw('text-8xl font-bold text-white ease-out enter-bounce-in-up/0/400 exit-fade-out-up/2600/400')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-## Programmatic Animations
-
-For complete control beyond animation classes, use `progress` and `frame` directly.
-
-### Available Props
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `progress` | `number` | 0 to 1 through the video (0% to 100%) |
-| `frame` | `number` | Current frame number (0, 1, 2, ... totalFrames-1) |
-
-These are **only available in video templates**. Use them when animation classes aren't flexible enough.
-
-### Using `frame`
-
-```tsx
-export default function FrameAnimation({ tw, frame, title }) {
-  // Color cycling using frame number
-  const hue = (frame * 5) % 360; // Cycle through colors
-
-  // Pulsing based on frame
-  const fps = 30;
-  const pulse = Math.sin(frame / fps * Math.PI * 2) * 0.2 + 0.8; // 0.6 to 1.0
-
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-black')}>
-      <h1 style={{
-        ...tw('text-8xl font-bold'),
-        color: `hsl(${hue}, 70%, 60%)`,
-        transform: `scale(${pulse})`
-      }}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-### Using `progress`
-
-```tsx
-export default function ProgressAnimation({ tw, progress, title }) {
-  // Custom fade based on progress
-  const opacity = progress < 0.3 ? progress / 0.3 : 1;
-
-  // Custom scale based on progress
-  const scale = 0.8 + progress * 0.2; // 0.8 to 1.0
-
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-gray-900')}>
-      <h1 style={{
-        ...tw('text-8xl font-bold text-white'),
-        opacity,
-        transform: `scale(${scale})`
-      }}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-### Custom Easing
-
-```tsx
-export default function CustomEasing({ tw, progress, title }) {
-  // Smoothstep easing
-  const eased = progress * progress * (3 - 2 * progress);
-
-  // Elastic easing
-  const elastic = Math.pow(2, -10 * progress) * Math.sin((progress - 0.075) * (2 * Math.PI) / 0.3) + 1;
-
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full')}>
-      <h1 style={{
-        ...tw('text-8xl font-bold'),
-        opacity: eased,
-        transform: `translateY(${(1 - elastic) * 100}px)`
-      }}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-### When to Use Programmatic Animations
-
-Use `progress`/`frame` instead of animation classes when you need:
-- **Custom easing functions** (elastic, spring, bounce with specific curves)
-- **Color cycling or gradients** based on time
-- **Mathematical animations** (sine waves, spirals, etc.)
-- **Complex multi-property animations** that need precise coordination
-- **Conditional logic** based on specific frame numbers
-
-For everything else, prefer animation classes - they're simpler and more maintainable.
-
-## Performance Tips
-
-1. **Use Tailwind classes** when possible - they're optimized for the renderer
-2. **Avoid too many nested animations** - each adds computation per frame
-3. **Use loop animations sparingly** - they're computed every frame
-4. **Prefer opacity and transform** - they're the most performant properties
-
-## Next Steps
-
-- [Video Templates](/video) - Creating video templates
-- [SDK](/sdk) - Programmatic rendering with animations
-- [Helpers](/helpers) - QR codes, images, and more
-
-
-
-
-================================================================================
-FILE: helpers.mdx
-================================================================================
-
-# Template Helpers
-
-Additional helpers for creating powerful, composable templates.
-
-## Overview
-
-Beyond the basics, loopwind provides:
-- `template()` - Compose templates together
-- `qr()` - Generate QR codes on the fly
-- `config` - Access user configuration
-
-For image embedding, see the [Images](/images) page.
-
-## Template Composition
-
-Compose multiple templates together to create complex designs.
-
-### Usage
-
-```tsx
-export default function CompositeCard({ tw, template, title, author, avatar }) {
-  return (
-    <div style={tw('w-full h-full bg-gradient-to-br from-purple-600 to-blue-500 p-12')}>
-      <div style={tw('bg-white rounded-2xl p-8 shadow-xl')}>
-        <h1 style={tw('text-4xl font-bold text-gray-900 mb-6')}>{title}</h1>
-        
-        {/* Embed another template */}
-        <div style={tw('mb-6')}>
-          {template('user-badge', {
-            name: author,
-            avatar: avatar
-          })}
-        </div>
-        
-        <p style={tw('text-gray-600')}>Published by {author}</p>
-      </div>
-    </div>
-  );
-}
-```
-
-**How it works:**
-1. `template(name, props)` renders another installed template
-2. The embedded template is rendered at its specified size
-3. You can embed multiple templates in one design
-4. Templates can be nested (template within a template)
-
-### Use Cases
-
-**1. Reusable components:**
-```tsx
-// Create a logo template once, use it everywhere
-<div>{template('company-logo', { variant: 'dark' })}</div>
-```
-
-**2. Complex layouts:**
-```tsx
-// Combine multiple templates into one design
-<div style={tw('grid grid-cols-2 gap-4')}>
-  {template('product-card', { product: product1 })}
-  {template('product-card', { product: product2 })}
-</div>
-```
-
-**3. Dynamic content:**
-```tsx
-// Render templates based on data
-{users.map(user => 
-  template('user-avatar', { name: user.name, image: user.avatar })
-)}
-```
-
-### Best Practices
-
-1. **Keep templates focused** - Each template should do one thing well
-2. **Pass minimal props** - Only pass what the embedded template needs
-3. **Document dependencies** - Note which templates are required in your README
-4. **Avoid deep nesting** - Too many nested templates can be hard to debug
-
-## QR Codes
-
-Generate QR codes dynamically in your templates.
-
-### Usage
-
-```tsx
-export default function QRCard({ tw, qr, title, url }) {
-  return (
-    <div style={tw('flex flex-col items-center justify-center w-full h-full bg-white p-10')}>
-      <h1 style={tw('text-4xl font-bold text-black mb-8')}>{title}</h1>
-      
-      {/* Generate QR code for the URL */}
-      <img src={qr(url)} style={tw('w-64 h-64')} />
-      
-      <p style={tw('text-gray-600 mt-4')}>{url}</p>
-    </div>
-  );
-}
-```
-
-**Props format:**
-```json
-{
-  "title": "Scan Me",
-  "url": "https://example.com"
-}
-```
-
-### QR Options
-
-You can customize QR code appearance:
-
-```tsx
-// Basic QR code
-<img src={qr('https://example.com')} />
-
-// With error correction level
-<img src={qr('https://example.com', { errorCorrectionLevel: 'H' })} />
-
-// With custom size
-<img src={qr('https://example.com', { width: 512 })} />
-```
-
-**Error correction levels:**
-- `L` - Low (~7% correction)
-- `M` - Medium (~15% correction) - default
-- `Q` - Quartile (~25% correction)
-- `H` - High (~30% correction)
-
-## User Configuration
-
-Access user settings from `_loopwind/loopwind.json` using the `config` prop:
-
-```tsx
-export default function BrandedTemplate({ tw, config, title }) {
-  // Access custom colors from loopwind.json
-  const primaryColor = config?.colors?.brand || '#6366f1';
-  
-  return (
-    <div style={tw('w-full h-full p-12')}>
-      <h1 style={{ 
-        ...tw('text-6xl font-bold'),
-        color: primaryColor 
-      }}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-**User's `_loopwind/loopwind.json`:**
-```json title="_loopwind/loopwind.json"
-{
-  "colors": {
-    "brand": "#ff6b6b"
-  },
-  "fonts": {
-    "sans": ["Inter", "system-ui", "sans-serif"]
-  }
-}
-```
-
-This allows templates to adapt to user preferences and brand guidelines.
-
-## All Props Reference
-
-Every template receives these props:
-
-```tsx
-export default function MyTemplate({ 
-  // Core helpers
-  tw,        // Tailwind class converter
-  qr,        // QR code generator (this page)
-  template,  // Template composer (this page)
-  config,    // User config from loopwind.json (this page)
-  
-  // Media helpers (see dedicated pages)
-  image,     // Image embedder → see /images
-
-  // Video-specific (only in video templates)
-  frame,     // Current frame number → see /video
-  progress,  // Animation progress 0-1 → see /video
-  
-  // Your custom props
-  ...props   // Any props from your props.json
-}) {
-  // Your template code
-}
-```
-
-## Next Steps
-
-- [Image Rendering and Embedding](/images)
-- [Video Animation](/video)
-- [Styling with Tailwind & shadcn/ui](/styling)
-- [Custom Fonts](/fonts)
-
-
-
-
-
-================================================================================
-FILE: styling.mdx
-================================================================================
-
-# Styling Templates
-
-Style your templates with Tailwind utility classes and shadcn/ui's beautiful design system.
-
-## Quick Start
-
-```tsx
-export default function MyTemplate({ title, tw }) {
-  return (
-    <div style={tw('flex items-center justify-center w-full h-full bg-gradient-to-br from-blue-600 to-purple-700')}>
-      <h1 style={tw('text-7xl font-bold text-white')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-## The `tw()` Function
-
-Every template receives a `tw()` function that converts Tailwind classes to inline styles compatible with Satori:
-
-```tsx
-// Tailwind classes
-tw('flex items-center justify-center p-8 bg-blue-500')
-
-// Converts to inline styles:
-{
-  display: 'flex',
-  alignItems: 'center',
-  justifyContent: 'center',
-  padding: '2rem',
-  backgroundColor: '#3b82f6'
-}
-```
-
-### Basic Usage
-
-```tsx
-export default function Banner({ title, subtitle, tw }) {
-  return (
-    <div style={tw('w-full h-full p-12 bg-gray-50')}>
-      <h1 style={tw('text-6xl font-bold text-gray-900 mb-4')}>
-        {title}
-      </h1>
-      <p style={tw('text-2xl text-gray-600')}>
-        {subtitle}
-      </p>
-    </div>
-  );
-}
-```
-
-### Combining with Custom Styles
-
-Mix Tailwind classes with custom styles using the spread operator:
-
-```tsx
-export default function CustomGradient({ title, tw }) {
-  return (
-    <div
-      style={{
-        ...tw('flex flex-col items-center justify-center w-full h-full p-20'),
-        background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
-      }}
-    >
-      <h1 style={tw('text-8xl font-bold text-white')}>{title}</h1>
-    </div>
-  );
-}
-```
-
-## shadcn/ui Design System
-
-loopwind uses **shadcn/ui's design system** by default, providing semantic color tokens for beautiful, consistent designs.
-
-### Default Color Palette
-
-All templates automatically have access to these semantic colors defined in `_loopwind/loopwind.json`:
-
-```typescript
-colors: {
-  // Primary colors
-  primary: '#18181b',           // Main brand color
-  'primary-foreground': '#fafafa',
-
-  // Secondary colors
-  secondary: '#f4f4f5',         // Subtle accents
-  'secondary-foreground': '#18181b',
-
-  // Background
-  background: '#ffffff',        // Page background
-  foreground: '#09090b',        // Main text color
-
-  // Muted
-  muted: '#f4f4f5',            // Subtle backgrounds
-  'muted-foreground': '#71717a', // Muted text
-
-  // Accent
-  accent: '#f4f4f5',           // Highlight color
-  'accent-foreground': '#18181b',
-
-  // Destructive
-  destructive: '#ef4444',       // Error/danger states
-  'destructive-foreground': '#fafafa',
-
-  // UI Elements
-  border: '#e4e4e7',           // Border color
-  input: '#e4e4e7',            // Input borders
-  ring: '#18181b',             // Focus rings
-  card: '#ffffff',             // Card background
-  'card-foreground': '#09090b',
-}
-```
-
-### Using Semantic Colors
-
-```tsx
-export default function SemanticCard({ title, description, price, tw }) {
-  return (
-    <div style={tw('bg-card border border-border rounded-lg p-6')}>
-      <h2 style={tw('text-card-foreground text-2xl font-bold mb-2')}>
-        {title}
-      </h2>
-      <p style={tw('text-muted-foreground mb-4')}>
-        {description}
-      </p>
-      <div style={tw('text-primary text-3xl font-bold')}>
-        ${price}
-      </div>
-    </div>
-  );
-}
-```
-
-### Opacity Modifiers
-
-Use Tailwind's slash syntax for opacity with any color:
-
-```tsx
-export default function OpacityExample({ tw }) {
-  return (
-    <div style={tw('bg-primary/50')}>          {/* 50% opacity */}
-      <p style={tw('text-muted-foreground/75')}> {/* 75% opacity */}
-        Subtle text
-      </p>
-      <div style={tw('border border-border/30')}> {/* 30% opacity */}
-        Faint border
-      </div>
-    </div>
-  );
-}
-```
-
-**Supported syntax:**
-- `bg-{color}/{opacity}` - Background with opacity
-- `text-{color}/{opacity}` - Text with opacity  
-- `border-{color}/{opacity}` - Border with opacity
-
-### Text Hierarchy
-
-```tsx
-// Primary text
-tw('text-foreground')
-
-// Secondary/muted text
-tw('text-muted-foreground')
-
-// Accent/brand text
-tw('text-primary')
-
-// Destructive/error text
-tw('text-destructive')
-```
-
-### Backgrounds
-
-```tsx
-// Page background
-tw('bg-background')
-
-// Card/elevated surfaces
-tw('bg-card')
-
-// Subtle backgrounds
-tw('bg-muted')
-
-// Accent backgrounds
-tw('bg-accent')
-```
-
-## Supported Tailwind Classes
-
-### Layout
-
-- **Display**: `flex`, `inline-flex`, `block`, `inline-block`, `hidden`
-- **Flex Direction**: `flex-row`, `flex-col`, `flex-row-reverse`, `flex-col-reverse`
-- **Justify**: `justify-start`, `justify-end`, `justify-center`, `justify-between`, `justify-around`
-- **Align**: `items-start`, `items-end`, `items-center`, `items-baseline`, `items-stretch`
-
-### Spacing
-
-- **Padding**: `p-{n}`, `px-{n}`, `py-{n}`, `pt-{n}`, `pb-{n}`, `pl-{n}`, `pr-{n}`
-- **Margin**: `m-{n}`, `mx-{n}`, `my-{n}`, `mt-{n}`, `mb-{n}`, `ml-{n}`, `mr-{n}`
-- **Gap**: `gap-{n}`, `gap-x-{n}`, `gap-y-{n}`
-- **Sizes**: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64
-
-Examples:
-```tsx
-tw('p-4')      // padding: 1rem
-tw('px-8')     // paddingLeft: 2rem, paddingRight: 2rem
-tw('m-6')      // margin: 1.5rem
-tw('gap-4')    // gap: 1rem
-```
-
-### Sizing
-
-- **Width**: `w-{n}`, `w-full`, `w-screen`, `w-1/2`, `w-1/3`, `w-2/3`
-- **Height**: `h-{n}`, `h-full`, `h-screen`
-
-Examples:
-```tsx
-tw('w-full')   // width: 100%
-tw('h-64')     // height: 16rem
-tw('w-1/2')    // width: 50%
-```
-
-### Typography
-
-- **Font Size**: `text-xs`, `text-sm`, `text-base`, `text-lg`, `text-xl`, `text-2xl`, `text-3xl`, `text-4xl`, `text-5xl`, `text-6xl`, `text-7xl`, `text-8xl`, `text-9xl`
-- **Font Weight**: `font-thin`, `font-light`, `font-normal`, `font-medium`, `font-semibold`, `font-bold`, `font-extrabold`, `font-black`
-- **Text Align**: `text-left`, `text-center`, `text-right`
-- **Line Height**: `leading-none`, `leading-tight`, `leading-normal`, `leading-relaxed`, `leading-loose`
-
-### Colors
-
-All standard Tailwind colors plus shadcn semantic colors:
-
-**Standard colors:**
-- `text-{color}-{shade}`, `bg-{color}-{shade}`, `border-{color}-{shade}`
-- Colors: `red`, `blue`, `green`, `yellow`, `purple`, `pink`, `gray`, `indigo`, `teal`, `orange`
-- Shades: `50`, `100`, `200`, `300`, `400`, `500`, `600`, `700`, `800`, `900`
-
-**shadcn semantic colors:**
-- `text-foreground`, `text-primary`, `text-muted-foreground`, `text-destructive`
-- `bg-background`, `bg-card`, `bg-muted`, `bg-accent`, `bg-primary`
-- `border-border`, `border-input`
-
-```tsx
-tw('text-blue-500')        // Standard Tailwind color
-tw('bg-purple-600')        // Standard Tailwind color
-tw('text-primary')         // shadcn semantic color
-tw('bg-card')              // shadcn semantic color
-```
-
-### Position & Layout
-
-- **Position**: `relative`, `absolute`, `fixed`, `sticky`
-- **Inset**: `inset-0`, `top-0`, `bottom-0`, `left-0`, `right-0`
-- **Z-Index**: `z-0`, `z-10`, `z-20`, `z-30`, `z-40`, `z-50`
-
-### Borders
-
-- **Border Width**: `border`, `border-{n}`, `border-t`, `border-b`, `border-l`, `border-r`
-- **Border Radius**: `rounded`, `rounded-sm`, `rounded-md`, `rounded-lg`, `rounded-xl`, `rounded-2xl`, `rounded-3xl`, `rounded-full`
-- **Border Color**: `border-{color}-{shade}`, `border-border`, `border-input`
-
-### Effects
-
-- **Shadow**: `shadow-sm`, `shadow`, `shadow-md`, `shadow-lg`, `shadow-xl`, `shadow-2xl`
-- **Opacity**: `opacity-0`, `opacity-25`, `opacity-50`, `opacity-75`, `opacity-100`
-
-### Filters
-
-- **Blur**: `blur-none`, `blur-sm`, `blur`, `blur-md`, `blur-lg`, `blur-xl`
-- **Brightness**: `brightness-0`, `brightness-50`, `brightness-100`, `brightness-150`, `brightness-200`
-- **Contrast**: `contrast-0`, `contrast-50`, `contrast-100`, `contrast-150`, `contrast-200`
-
-## Gradients
-
-### Linear Gradients
-
-```tsx
-// Gradient direction
-tw('bg-gradient-to-r')      // left to right
-tw('bg-gradient-to-br')     // top-left to bottom-right
-tw('bg-gradient-to-t')      // bottom to top
-
-// Gradient colors
-tw('from-blue-500')         // Start color
-tw('via-purple-500')        // Middle color
-tw('to-pink-500')           // End color
-
-// Complete gradient
-tw('bg-gradient-to-r from-blue-500 via-purple-500 to-pink-500')
-```
-
-### Gradient Examples
-
-```tsx
-export default function GradientCard({ title, tw }) {
-  return (
-    <div style={tw('w-full h-full bg-gradient-to-br from-cyan-500 to-blue-600 p-12')}>
-      <h1 style={tw('text-white text-6xl font-bold')}>
-        {title}
-      </h1>
-    </div>
-  );
-}
-```
-
-## Custom Theme Colors
-
-You can override the default shadcn colors or add your own custom colors in `_loopwind/loopwind.json`:
-
-```json title="_loopwind/loopwind.json"
-{
-  "theme": {
-    "colors": {
-      "primary": "#3b82f6",
-      "primary-foreground": "#ffffff",
-      "accent": "#10b981",
-      "brand": "#ff6b6b"
-    }
-  }
-}
-```
-
-Then use these custom colors in your templates:
-
-```tsx
-tw('text-brand')    // Uses your custom brand color
-tw('bg-primary')    // Uses your custom primary color
-tw('bg-accent')     // Uses your custom accent color
-```
-
-## Auto-Detection from tailwind.config.js
-
-loopwind automatically detects and loads your project's Tailwind configuration:
-
-```
-your-project/
-├── tailwind.config.js  ← Automatically detected
-└── _loopwind/
-    ├── loopwind.json
-    └── templates/
-```
-
-This includes:
-- Custom colors
-- Custom spacing values
-- Custom fonts
-- Theme extensions
-- Custom utilities
-
-## Complete Example
-
-```tsx
-export default function ModernCard({ 
-  tw, 
-  image,
-  title, 
-  description, 
-  category,
-  author,
-  avatar 
-}) {
-  return (
-    <div style={tw('w-full h-full bg-card')}>
-      {/* Hero image */}
-      <div style={tw('relative h-2/3')}>
-        <img 
-          src={image(hero)} 
-          style={tw('w-full h-full object-cover')}
-        />
-        {/* Category badge */}
-        <div style={tw('absolute top-4 left-4 bg-primary/90 backdrop-blur px-4 py-2 rounded-full')}>
-          <span style={tw('text-sm font-semibold text-primary-foreground')}>
-            {category}
-          </span>
-        </div>
-      </div>
-      
-      {/* Content */}
-      <div style={tw('h-1/3 p-8 flex flex-col justify-between')}>
-        <div>
-          <h2 style={tw('text-3xl font-bold text-foreground mb-2')}>
-            {title}
-          </h2>
-          <p style={tw('text-muted-foreground line-clamp-2')}>
-            {description}
-          </p>
-        </div>
-        
-        {/* Author */}
-        <div style={tw('flex items-center gap-3')}>
-          <img 
-            src={image(avatar)} 
-            style={tw('w-10 h-10 rounded-full border-2 border-border')}
-          />
-          <span style={tw('text-sm text-muted-foreground')}>
-            {author}
-          </span>
-        </div>
-      </div>
-    </div>
-  );
-}
-```
-
-## Why This Approach?
-
-- **Semantic naming**: `text-primary` instead of `text-blue-600`
-- **Consistency**: All templates use the same design language
-- **Flexibility**: Easy to customize entire theme
-- **Accessibility**: Pre-tested color contrasts
-- **Modern**: Same system as shadcn/ui components
-- **Familiar**: Standard Tailwind syntax
-
-## Next Steps
-
-- [Custom Fonts](/fonts)
-- [Built-in Helpers](/helpers)
-- [Image Rendering](/images)
-- [Video Rendering](/video)
-
-
-
-
-
-================================================================================
-FILE: fonts.mdx
-================================================================================
-
-# Font Handling in loopwind
-
-The recommended way to use fonts is through `loopwind.json` - configure fonts once, use everywhere.
-
-## Using Fonts from loopwind.json (Recommended)
-
-Configure fonts in your `_loopwind/loopwind.json` and use Tailwind classes in templates.
-
-### Simple Setup
-
-Define font families in `_loopwind/loopwind.json` without loading custom fonts (uses system fonts):
-
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": ["Inter", "system-ui", "-apple-system", "sans-serif"],
-    "serif": ["Georgia", "serif"],
-    "mono": ["Courier New", "monospace"]
-  }
-}
-```
-
-**Template usage:**
-```tsx
-export default function({ title, tw }) {
-  return (
-    <div style={tw('w-full h-full')}>
-      {/* Uses fonts.sans from loopwind.json */}
-      <h1 style={tw('font-sans text-6xl font-bold')}>
-        {title}
-      </h1>
-
-      {/* Uses fonts.mono from loopwind.json */}
-      <code style={tw('font-mono text-sm')}>
-        {code}
-      </code>
-    </div>
-  );
-}
-```
-
-**Result:** Uses system fonts, falls back to Inter for rendering.
-
-### Complete Setup (With Font Files)
-
-Load custom font files for brand-specific typography in `_loopwind/loopwind.json`:
-
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": {
-      "family": ["Inter", "system-ui", "sans-serif"],
-      "files": [
-        { "path": "./fonts/Inter-Regular.woff", "weight": 400 },
-        { "path": "./fonts/Inter-Bold.woff", "weight": 700 }
-      ]
-    },
-    "mono": {
-      "family": ["JetBrains Mono", "monospace"],
-      "files": [
-        { "path": "./fonts/JetBrainsMono-Regular.woff", "weight": 400 }
-      ]
-    }
-  }
-}
-```
-
-**Project structure:**
-```
-your-project/
-├── _loopwind/
-│   ├── loopwind.json
-│   └── templates/
-└── fonts/
-    ├── Inter-Regular.woff
-    ├── Inter-Bold.woff
-    └── JetBrainsMono-Regular.woff
-```
-
-**Template usage (same as before):**
-```tsx
-<h1 style={tw('font-sans font-bold')}>
-  {/* Uses Inter Bold from loopwind.json */}
-  {title}
-</h1>
-```
-
-**Available classes:**
-- `font-sans` - Uses `fonts.sans` from loopwind.json
-- `font-serif` - Uses `fonts.serif` from loopwind.json
-- `font-mono` - Uses `fonts.mono` from loopwind.json
-
-**Supported formats:**
-- ✅ **WOFF** (`.woff`) - Recommended for best compatibility
-- ✅ **TTF** (`.ttf`) - Also supported
-- ✅ **OTF** (`.otf`) - Also supported
-- ❌ **WOFF2** (`.woff2`) - Not supported by renderer
-
-## Font Loading Priority
-
-loopwind loads fonts in this order:
-
-1. **loopwind.json fonts** (if configured with `files`)
-2. **Bundled Inter fonts** (included with CLI)
-
-This ensures fonts work out of the box with no configuration.
-
-## Default Fonts
-
-If no fonts are configured, loopwind uses **Inter** (Regular 400, Bold 700) which is bundled with the CLI. This means fonts work offline with no configuration required.
-
-## Best Practices
-
-1. ✅ **Use loopwind.json for project-wide fonts** - Configure once, use everywhere
-2. ✅ **Use font classes** - `tw('font-sans')` instead of `fontFamily: 'Inter'`
-3. ✅ **Include fallbacks** - Always add system fonts: `["Inter", "system-ui", "sans-serif"]`
-4. ✅ **Match names** - First font in `family` array is used as the loaded font name
-5. ✅ **Relative paths** - Font paths are relative to `loopwind.json` location
-
-## Examples
-
-### Minimal Setup (System Fonts)
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": ["Inter", "-apple-system", "sans-serif"]
-  }
-}
-```
-Uses system Inter if available, falls back to Noto Sans for rendering.
-
-### Brand Fonts Setup
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": {
-      "family": ["Montserrat", "sans-serif"],
-      "files": [
-        { "path": "./fonts/Montserrat-Regular.woff", "weight": 400 },
-        { "path": "./fonts/Montserrat-Bold.woff", "weight": 700 }
-      ]
-    }
-  }
-}
-```
-Loads and uses Montserrat for all templates.
-
-### Multi-Font Setup
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": {
-      "family": ["Inter", "sans-serif"],
-      "files": [
-        { "path": "./fonts/Inter-Regular.woff", "weight": 400 },
-        { "path": "./fonts/Inter-Bold.woff", "weight": 700 }
-      ]
-    },
-    "serif": {
-      "family": ["Playfair Display", "serif"],
-      "files": [
-        { "path": "./fonts/Playfair-Regular.woff", "weight": 400 }
-      ]
-    },
-    "mono": {
-      "family": ["Fira Code", "monospace"],
-      "files": [
-        { "path": "./fonts/FiraCode-Regular.woff", "weight": 400 }
-      ]
-    }
-  }
-}
-```
-Loads different fonts for each style class.
-
-### External Font URLs
-Load fonts directly from CDNs without downloading files:
-
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": {
-      "family": ["Inter", "sans-serif"],
-      "files": [
-        {
-          "path": "https://unpkg.com/@fontsource/inter@5.0.18/files/inter-latin-400-normal.woff",
-          "weight": 400
-        },
-        {
-          "path": "https://unpkg.com/@fontsource/inter@5.0.18/files/inter-latin-700-normal.woff",
-          "weight": 700
-        }
-      ]
-    }
-  }
-}
-```
-
-You can also mix local and external fonts:
-
-```json title="_loopwind/loopwind.json"
-{
-  "fonts": {
-    "sans": {
-      "family": ["Inter", "sans-serif"],
-      "files": [
-        { "path": "./fonts/Inter-Regular.woff", "weight": 400 },
-        {
-          "path": "https://unpkg.com/@fontsource/inter@5.0.18/files/inter-latin-700-normal.woff",
-          "weight": 700
-        }
-      ]
-    }
-  }
-}
-```
-
-**Note:** Use WOFF format (`.woff`) for best compatibility. WOFF2 is not supported by the underlying renderer.
-
-## Performance
-
-- ✅ **Font caching** - Fonts load once and are cached for all renders
-- ✅ **Video optimization** - 90-frame video loads fonts once, not 90 times
-- ✅ **No CDN delays** - Local fonts load instantly
-
-## Next Steps
-
-- [Styling with Tailwind & shadcn/ui](/styling)
-- [Built-in Helpers](/helpers)
-- [Image Rendering](/images)
-- [Video Rendering](/video)
-
-
-
-
-================================================================================
-FILE: agents.mdx
-================================================================================
-
-# AI Agents
-
-loopwind is designed to work with AI coding assistants. Simply add the `_loopwind` folder to context.
-
-## Using with AI Code Agents
-
-In Cursor or Claude Code (Cline), type `@_loopwind` to add the folder to context, then ask:
-
-```
-Generate an Open Graph image for my blog post about React hooks
-```
-
-The AI will read the templates and generate the appropriate command.
-
-## The AGENTS.md File
-
-When you run `loopwind init`, a `_loopwind/AGENTS.md` file is created with:
-- Essential commands
-- Template helpers reference
-- Common workflows
-
-This gives AI agents everything they need to use loopwind effectively.
-
-## Example Workflows
-
-### Simple Image Generation
-
-**Prompt:**
-```
-Create a social media card using the og-image template:
-- Title: "10 React Tips"  
-- Description: "Learn advanced patterns"
-```
-
-**AI generates:**
-```bash
-loopwind render og-image '{"title":"10 React Tips","description":"Learn advanced patterns"}'
-```
-
-**Output:** `_loopwind/outputs/og-image.png`
-
-### Changelog Image
-
-**Prompt:**
-```
-Create a changelog image for 3 recent changes:
-- Added video rendering support
-- Improved template validation
-- Fixed font loading issues
-```
-
-**AI generates:**
-```bash
-loopwind render changelog-card '{
-  "title":"Version 1.2.0",
-  "changes":[
-    "Added video rendering support",
-    "Improved template validation",
-    "Fixed font loading issues"
-  ]
-}'
-```
-
-**Output:** `_loopwind/outputs/changelog-card.png`
-
-## Next Steps
-
-- [Learn about Templates](/templates)
-- [Image Rendering](/images)
-- [Video Rendering](/video)
-- [Built-in Helpers](/helpers)
-
-
-