Files
the-nexus/docs/media/README.md
Alexander Whitestone b6980409f6
Some checks failed
Deploy Nexus / deploy (push) Has been cancelled
Staging Verification Gate / verify-staging (push) Has been cancelled
fix: [MEDIA] Veo/Flow flythrough prototypes for The Nexus and Timmy
Closes #1194

Automated squash merge by mimo swarm.
2026-04-11 00:20:14 +00:00

92 lines
2.8 KiB
Markdown

# 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