# Onboarding Video Series

A six-part onboarding series that gets new users from first login to a complete,
shareable project.

## Series Goals

- Help new users understand the core Yemaya workflow in under 40 minutes total.
- Show a realistic end-to-end path: project setup -> script -> storyboard ->
  assets -> collaboration -> AI tools.
- Reinforce where to find help (docs, contextual help, and templates).

## Target Audience

- New users evaluating Yemaya for film, game, or animation production.
- Project owners and producers onboarding a team.

## Demo Project (Used Across All Videos)

Project name: Nebula Heist Project type: Film Structure:

```
nebula-heist/
├── 01-preproduction/
│   ├── scripts/
│   ├── storyboards/
│   └── shot-lists/
├── 02-assets/
│   ├── characters/
│   ├── environments/
│   └── props/
└── 03-production/
    ├── animatics/
    └── exports/
```

Core assets to prepare:

- Script: 3-page Fountain scene (opening heist sequence)
- Storyboard frames: 6 PNG frames (simple sketches)
- Hero character model: placeholder FBX
- Environment concept: 1 JPG concept art image
- SFX: 1 WAV file for door hiss

## Video Index

| ID    | Title                       | Duration | Outcome                                              |
| ----- | --------------------------- | -------- | ---------------------------------------------------- |
| OV-01 | Welcome to Yemaya           | 3:30     | Users understand the platform layout and value.      |
| OV-02 | Create Your First Project   | 6:00     | Users can create and configure a project.            |
| OV-03 | Script and Structure Basics | 7:00     | Users can write a script and apply story structure.  |
| OV-04 | Storyboards and Shot Lists  | 7:00     | Users can build a storyboard and export a shot list. |
| OV-05 | Assets and Versioning       | 6:00     | Users can upload, tag, and version assets.           |
| OV-06 | Collaboration and AI Tools  | 7:00     | Users can invite collaborators and use AI tools.     |

---

## OV-01: Welcome to Yemaya (3:30)

### Objective

Explain the Yemaya workspace layout, main navigation, and where to start.

### Recording Setup

- Start on the Welcome page.
- Cursor highlight enabled.
- Browser zoom 100%.

### Script and Shot List

- 0:00-0:15
  - VO: "Welcome to Yemaya, the end-to-end studio for film, game, and animation
    production."
  - On-screen: Landing page with logo, quick actions.
- 0:15-0:45
  - VO: "Everything starts on your dashboard. From here you can create projects,
    browse templates, and jump back into recent work."
  - On-screen: Hover over New Project and From Template buttons.
- 0:45-1:20
  - VO: "The header keeps you anchored: projects, templates, settings, and your
    profile."
  - On-screen: Highlight header navigation and settings.
- 1:20-2:10
  - VO: "The sidebar is your workspace map. Scripts, storyboards, assets, and
    settings are one click away."
  - On-screen: Open sidebar, hover over each section.
- 2:10-2:50
  - VO: "Each page includes contextual help and links to deeper documentation."
  - On-screen: Show help icon and docs link.
- 2:50-3:30
  - VO: "Next, we will create a project and start building Nebula Heist."
  - On-screen: Click New Project.

### Chapters

- 0:00 Welcome
- 0:45 Navigation
- 1:20 Sidebar
- 2:10 Help and resources
- 2:50 Next steps

### Post-Production Notes

- Add lower third: "Welcome to Yemaya" at 0:02.
- Add callouts for Projects, Templates, Settings.
- End with CTA: "Create your first project".

---

## OV-02: Create Your First Project (6:00)

### Objective

Create a new project, choose a template, and set collaboration defaults.

### Recording Setup

- Begin from Welcome page.
- Use the Nebula Heist project name.

### Script and Shot List

- 0:00-0:30
  - VO: "Let us create a new project for our short film, Nebula Heist."
  - On-screen: Click New Project.
- 0:30-1:30
  - VO: "Pick a project type. Film projects include storyboard and animatic
    defaults."
  - On-screen: Select Film, show template options.
- 1:30-2:30
  - VO: "Set the basics: name, description, visibility, and storage region."
  - On-screen: Fill form fields, keep advanced settings collapsed.
- 2:30-3:20
  - VO: "Enable collaboration defaults so teammates can comment and review."
  - On-screen: Toggle collaboration settings.
- 3:20-4:30
  - VO: "Yemaya generates the folder structure automatically. You can customize
    later."
  - On-screen: Show folder tree.
- 4:30-5:30
  - VO: "Create the project and land in the workspace."
  - On-screen: Create project, show empty workspace.
- 5:30-6:00
  - VO: "Next, we will draft the opening scene in the script editor."
  - On-screen: Navigate to Scripts.

### Chapters

- 0:00 Start a project
- 1:30 Project settings
- 2:30 Collaboration defaults
- 3:20 Folder structure
- 4:30 Launch workspace

### Post-Production Notes

- Add annotation for template selection.
- Include short zoom on folder structure.
- End with CTA: "Open the script editor".

---

## OV-03: Script and Structure Basics (7:00)

### Objective

Write a short script using Fountain formatting and apply a story structure
template.

### Recording Setup

- Open Scripts from the project sidebar.
- Use the pre-written Fountain snippet from the demo project.

### Script and Shot List

- 0:00-0:40
  - VO: "Yemaya uses Fountain for screenplay formatting. It is plain text and
    version friendly."
  - On-screen: Open script editor, show blank script.
- 0:40-2:00
  - VO: "Add scene headings, action, and dialogue. Yemaya auto-completes
    character names."
  - On-screen: Type the opening scene and show auto-complete.
- 2:00-3:00
  - VO: "Use the Structure panel to map your script to a proven beat sheet."
  - On-screen: Open Structure, choose Save the Cat, show beats.
- 3:00-4:30
  - VO: "Assign scenes to beats so your story arc stays clear."
  - On-screen: Drag scene to Catalyst and Debate beats.
- 4:30-5:30
  - VO: "Add tags for locations, characters, and props to feed downstream
    tools."
  - On-screen: Add tags in metadata panel.
- 5:30-6:30
  - VO: "Export options include PDF, Fountain, and Final Draft."
  - On-screen: Open export menu.
- 6:30-7:00
  - VO: "Next, we will convert these scenes into storyboards."
  - On-screen: Navigate to Storyboards.

### Chapters

- 0:00 Fountain basics
- 2:00 Story structure
- 4:30 Tags and metadata
- 5:30 Export

### Post-Production Notes

- Include keyboard shortcut overlay for scene heading.
- Add lower third: "Fountain Formatting" at 0:10.

---

## OV-04: Storyboards and Shot Lists (7:00)

### Objective

Create storyboard frames, organize shots, and export a shot list.

### Recording Setup

- Open Storyboards from sidebar.
- Load the 6 prepared storyboard frames.

### Script and Shot List

- 0:00-0:45
  - VO: "Storyboards turn your script into visual beats."
  - On-screen: Open storyboard board view.
- 0:45-2:00
  - VO: "Create a new board for Scene 1 and add frames."
  - On-screen: New board, drag in PNG frames.
- 2:00-3:00
  - VO: "Each frame can include camera notes, lens, and duration."
  - On-screen: Fill camera notes and lens fields.
- 3:00-4:00
  - VO: "Group frames into shots and sequence them on the timeline."
  - On-screen: Show timeline view, reorder frames.
- 4:00-5:00
  - VO: "Generate a shot list for production planning."
  - On-screen: Export shot list.
- 5:00-6:00
  - VO: "Attach reference images and concept art to align the team."
  - On-screen: Attach environment concept image.
- 6:00-7:00
  - VO: "Next, we will organize the assets that power the project."
  - On-screen: Navigate to Assets.

### Chapters

- 0:00 Create boards
- 2:00 Frame metadata
- 3:00 Timeline sequencing
- 4:00 Shot list export
- 5:00 Reference assets

### Post-Production Notes

- Add callout: "Timeline view" at 3:05.
- Use zoom on camera notes field.

---

## OV-05: Assets and Versioning (6:00)

### Objective

Upload assets, tag them, and manage versions.

### Recording Setup

- Use the Assets section.
- Prepare the FBX, concept art JPG, and WAV file.

### Script and Shot List

- 0:00-0:40
  - VO: "Assets are everything your project uses: models, audio, scripts, and
    more."
  - On-screen: Asset dashboard overview.
- 0:40-1:40
  - VO: "Drag and drop files or use the upload button."
  - On-screen: Upload three demo files.
- 1:40-2:40
  - VO: "Add tags and descriptions so your team can search fast."
  - On-screen: Add tags "hero", "vault", "sfx".
- 2:40-3:40
  - VO: "Versioning keeps every revision safe. Upload a new version with notes."
  - On-screen: Upload new version, add changelog.
- 3:40-4:40
  - VO: "Use folders to mirror your pipeline phases."
  - On-screen: Move assets into folders.
- 4:40-6:00
  - VO: "Next, we will invite collaborators and use AI tools to accelerate
    work."
  - On-screen: Navigate to Collaboration.

### Chapters

- 0:00 Asset overview
- 0:40 Upload
- 1:40 Tagging
- 2:40 Versioning
- 3:40 Organization

### Post-Production Notes

- Add callout: "Version history" when showing changelog.
- Highlight drag and drop area.

---

## OV-06: Collaboration and AI Tools (7:00)

### Objective

Invite collaborators, leave feedback, and generate AI-assisted content.

### Recording Setup

- Use a test collaborator account (second browser profile).
- Prepare a comment thread on a storyboard frame.

### Script and Shot List

- 0:00-0:50
  - VO: "Collaboration keeps production aligned. Invite team members with
    roles."
  - On-screen: Open team settings, invite member.
- 0:50-2:00
  - VO: "Comments and annotations live next to the work."
  - On-screen: Add comment on storyboard frame.
- 2:00-3:00
  - VO: "Track feedback with status and assignments."
  - On-screen: Mark comment as resolved, assign follow-up.
- 3:00-4:30
  - VO: "Now try an AI tool. Generate a scene summary and concept ideas."
  - On-screen: Open AI tools, run summary.
- 4:30-6:00
  - VO: "AI output is saved as assets or notes so the team can iterate."
  - On-screen: Save AI result to notes.
- 6:00-7:00
  - VO: "You are ready to build. Explore templates and the full docs for deeper
    workflows."
  - On-screen: Show docs link.

### Chapters

- 0:00 Invite team
- 0:50 Comments
- 2:00 Feedback tracking
- 3:00 AI tools
- 4:30 Save results

### Post-Production Notes

- Use split-screen for collaboration moment.
- Add CTA: "Explore full documentation" at end.
