# Media Production — Veo/Flow Prototypes

Issue #681: [MEDIA] Veo/Flow flythrough prototypes for The Nexus and Timmy.

## Contents

- `veo-storyboard.md` — Full storyboard for 5 clips with shot sequences, prompts, and design focus areas
- `clip-metadata.json` — Durable metadata for each clip (prompts, model, outputs, insights)

## Clips Overview

| ID | Title | Audience | Purpose |
|----|-------|----------|---------|
| clip-001 | First Light | PUBLIC | The Nexus reveal teaser |
| clip-002 | Between Worlds | INTERNAL | Portal activation UX study |
| clip-003 | The Guardian's View | PUBLIC | Timmy's presence promo |
| clip-004 | The Void Between | INTERNAL | Ambient environment study |
| clip-005 | Command Center | INTERNAL | Terminal UI readability |

## How to Generate

### Via Flow (labs.google/flow)
1. Open `veo-storyboard.md`, copy the prompt for your clip
2. Go to labs.google/flow
3. Paste the prompt, select Veo 3.1
4. Generate (8-second clips)
5. Download output, update `clip-metadata.json` with output path and findings

### Via Gemini App
1. Type "generate a video of [prompt text]" in Gemini
2. Uses Veo 3.1 Fast (slightly lower quality, faster)
3. Good for quick iteration on prompts

### Via API (programmatic)
```python
from google import genai
client = genai.Client()

# See: ai.google.dev/gemini-api/docs/video
response = client.models.generate_content(
    model="veo-3.1",
    contents="[prompt from storyboard]"
)
```

## After Generation

For each clip:
1. Save output file to `outputs/clip-XXX.mp4`
2. Update `clip-metadata.json`:
   - Add output file path to `output_files[]`
   - Fill in `design_insights.findings` with observations
   - Add `threejs_changes_suggested` if the clip reveals needed changes
3. Share internal clips with the team for design review
4. Use public clips in README, social media, project communication

## Design Insight Workflow

Each clip has specific questions it's designed to answer:

**clip-001 (First Light)**
- Scale perception: platform vs. portals vs. terminal
- Color hierarchy: teal primary, purple secondary, gold accent
- Camera movement: cinematic or disorienting?

**clip-002 (Between Worlds)**
- Activation distance: when does interaction become available?
- Transition feel: travel or teleportation?
- Overlay readability against portal glow

**clip-003 (The Guardian's View)**
- Agent presence: alive or decorative?
- Crystal hologram readability
- Wide shot: world or tech demo?

**clip-004 (The Void Between)**
- Void atmosphere: alive or empty?
- Particle systems: enhance or distract?
- Lighting hierarchy clarity

**clip-005 (Command Center)**
- Text readability at 1080p
- Color-coded panel hierarchy
- Scan-line effect: retro or futuristic?

## Constraints

- 8-second clips max (Veo/Flow limitation)
- Queued generation (not instant)
- Content policies apply
- Ultra tier gets highest rate limits