Video user guide

This guide defines the product walkthrough used to document Obscura Flow with a clear, user-focused video.

Goal

The video should explain the complete workflow: create or open a workspace, organize projects, inspect metadata, archive, validate integrity, back up, restore, and diagnose operational issues.

Audience

Photographers and studios learning the workflow.
Digital technicians and archive managers operating workspaces.
Support, QA, and product teams reviewing critical screens.

Chapters

Chapter	User goal	Screens
Introduction	Understand workspace, project, archive, and restore	Home, sidebar, badges
Profile and sync	Identify account, license, API, and sync state	Profile, sync panel, API health
Workspace	Create, find, and load a workspace	New workspace, My workspaces
Projects	Create or import and inspect projects	Project list, import wizard, project detail
Metadata	Scan and read EXIF metadata	EXIF panel, JSON, filters
Archive	Understand archive eligibility, history, and checksum	Archive actions, archive cards
Operations centers	Diagnose, verify, and restore	Integrity, Health, Restore, Data lineage
Remote and sync	Understand remote backup and offline behavior	Sync panel, remote backup, cloud states
Settings	Configure workflow policies	Settings tabs
Logs and help	Audit activity and find support information	Logs, command palette, documentation, About

Coverage checklist

Home and active workspace.
Local and remote workspace browser.
Project list, import wizard, project detail, and EXIF.
Archive history, integrity, health, restore, and data lineage.
Remote backup, sync, offline/online states, settings, logs, documentation, and About.

Known limits

Native macOS menus and system file pickers require an Electron-native capture. Destructive restore, real remote backup, and real filesystem mutations should remain simulated for the documentation video.

Replay workflow

npm run docs:user-video:force

From the Starlight documentation repository:

make video-update