A project is the fundamental unit of creative work in WZRD Studio. Everything you generate — storylines, scenes, shots, video clips, audio tracks, and exported timelines — lives inside a project. Opening a project drops you into a multi-view workspace where each view surfaces a different layer of your production: the generative Studio canvas, the sequence Timeline, the non-linear Editor, and the finished Director’s Cut.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/gratitude5dee/wzrd-studio-desktopfinal/llms.txt
Use this file to discover all available pages before exploring further.
Project Structure
Each project is a self-contained container backed by a Supabase row. It holds:- Storylines — narrative outlines and scene breakdowns generated by text models
- Scenes & Shots — structured units that drive image and video generation
- Assets — all generated and uploaded media (images, videos, audio)
- Editor state — clip arrangement, timing, transitions, and audio mix
- Observability logs — a history of every generation job submitted for this project
Dashboard: Your Project Home
The Home dashboard at/home is the starting point after login. It renders all your projects in a responsive grid or list, with a live stats bar showing total project count, recent activity, generated assets, and available credits.
Filter Views
Sidebar navigation filters projects by type: All, Aura, Asset Store, IP Vault, Shared, and Community.
Search & Sort
Full-text search across project titles and descriptions. Sort by Last Updated, Name, or Created Date.
View Modes
Toggle between Grid (card layout) and List (tabular) view using the view-mode selector in the header.
Visibility Tabs
Filter between All, Private, and Public projects using the tab bar directly below the dashboard header.
Creating a Project
New projects are created through the Project Setup Wizard at/project-setup. The wizard is lazy-loaded for fast initial render, falling back to a skeleton shell while the wizard bundle is fetched.
Name and describe your project
Enter a project title and optional description. These fields are searchable from the dashboard.
Choose your AI models
Pick default image and video models for shot generation. You can override these per-shot later inside the Studio.
Generate your storyline
Optionally generate a storyline using a text model. The wizard creates an initial scene and shot structure you can refine.
Project Views
Each project exposes five canonical URL routes. All legacy URL patterns (e.g./studio/:projectId, /timeline/:projectId) automatically redirect to the canonical equivalents.
Studio
/projects/:projectId/studio — Node-based generation canvas. Connect prompts, reference assets, and models into visual generation graphs.Timeline
/projects/:projectId/timeline — Storyboard-style shot sequencer. Generate images and videos for each shot, arrange them in order, and preview the sequence.Editor
/projects/:projectId/editor — Non-linear video editor. Arrange clips on tracks, trim, add transitions, mix audio, and export the final cut.Director's Cut
/projects/:projectId/directors-cut — Single-click AI composition. WZRD assembles your shots into a finished video using FFmpeg Compose (costs 12 credits).Observability
/projects/:projectId/observability — Real-time generation job tracker. Inspect status, latency, credit spend, and error details for every generation request submitted under this project.Legacy Routes
WZRD maintains backwards-compatible redirects for older URL shapes. These are recognized and resolved to canonical routes automatically at runtime — no manual migration is needed.| Legacy Pattern | Resolves To |
|---|---|
/studio/:projectId | /projects/:projectId/studio |
/timeline/:projectId | /projects/:projectId/timeline |
/timeline/:projectId/directors-cut | /projects/:projectId/directors-cut |
/editor/:projectId | /projects/:projectId/editor |
/video-editor/:projectId | /projects/:projectId/editor |
/storyboard/:projectId | /projects/:projectId/studio |
/project/:projectId/timeline | /projects/:projectId/timeline |
The route resolution logic lives in
src/lib/routes.ts. getCanonicalProjectRoute(view, projectId) returns the correct canonical URL for any CoreProjectView value (studio, timeline, editor, directors-cut).Collaboration
From the Home dashboard you can invite collaborators and create share links for any project.Invite Collaborators
Click Invite in the dashboard header to add team members to a project by email. Collaborators share access to all project views.
Public / Private
Toggle project visibility between Private (only you and invited collaborators) and Public (visible in the Community view). The visibility state is reflected immediately in the dashboard tabs.
Asset Management
Global project assets are accessible at/assets. This page lists all uploaded and AI-generated media across all projects, with filtering by media type (image, video, audio) and project association.
Renaming and Deleting Projects
Right-click any project card on the dashboard (or use the card’s overflow menu) to:- Rename — edit the title inline; changes sync to Supabase immediately
- Delete — soft-deletes the project (sets
status = 'deleted'); deleted projects are filtered from all dashboard views - Restore — a
project-restoredevent re-fetches the project list so the restored project reappears without a full page reload