Knowledge Base updated: 2026-11-16
Knowledge Base Index
Orientation
OpenCut is a monorepo for a video/editor product with a web app, a Rust desktop app, a small API worker, and media/tooling support. The highest-level product flow is launching an editor surface from the web or desktop UI, with shared repository tooling coordinating builds and checks.
Main parts:
apps/web— browser app, routing, editor route, reusable web UI primitives, and deployment config.apps/desktop— Rust desktop application shell, themed UI primitives, and panel-based editor layout.apps/api— API/Cloudflare Worker entrypoint.crates/media— media setup scripts and FFmpeg dependency metadata.- Repository tooling and automation — Moon/Bun/Rust workspace config plus GitHub workflows.
Critical state is minimal in this repository snapshot: there is no documented database, queue, cache, or object-store layer. Runtime/editor state appears to live inside the web or desktop UI flows documented below, while build and dependency state is encoded in workspace manifests and lockfiles.
Architecture diagrams
flowchart TD
subgraph Apps
Web[apps/web]
Desktop[apps/desktop]
API[apps/api]
end
subgraph SharedTooling[workspace tooling]
Moon[moon.yml and .moon]
Bun[bunfig/package config]
Cargo[Cargo workspace]
end
subgraph Support
Media[crates/media]
CI[.github/workflows]
Brand[brand and changelog]
end
Web --> API
Web --> Bun
Desktop --> Cargo
Desktop --> Media
API --> Bun
Moon --> Web
Moon --> API
Moon --> Desktop
CI --> Moon
CI --> Media
Brand --> Web
flowchart LR
Browser[Browser] --> Router[apps/web/src/router.tsx]
Router --> Root[__root.tsx]
Root --> Home[index.tsx]
Root --> Editor[editor.tsx]
Editor --> Hooks[hooks]
Editor --> Utils[lib]
Editor --> UI[components/ui]
flowchart LR
Main[main.rs] --> Shell[shell.rs]
Shell --> Theme[theme.rs]
Shell --> Panels[panels]
Shell --> Components[components]
Panels --> BrowserPanel[browser]
Panels --> PreviewPanel[preview]
Panels --> TimelinePanel[timeline]
Panels --> InspectorPanel[inspector]
flowchart TD
Workflow[.github/workflows] --> Workspace[Moon workspace]
Workflow --> WebChecks[web/api Bun tasks]
Workflow --> DesktopChecks[Rust/Cargo tasks]
Workflow --> MediaDeps[media dependency setup]
MediaDeps --> FFmpeg[FFmpeg metadata]
Glossary
- OpenCut — the product/repository name for the editor application surfaces in this monorepo.
- Moon — the workspace/task orchestration layer configured by moon.yml and
.moon/**. - GPUI — the Rust desktop UI framework used by the desktop shell/components.
- FFmpeg — external media tooling dependency managed by
crates/mediasetup files.
Codebase-wide invariants
- Product code is partitioned by top-level workspace area: deployable apps live under
apps/*, while reusable/support crates live undercrates/*. - The web app’s file-based routes live under
apps/web/src/routes/**, with routing entry/generated route state represented by apps/…/router.tsx and apps/…/routeTree.gen.ts. - The desktop app separates shell-level composition from reusable primitives: apps/…/shell.rs and apps/…/theme.rs compose modules under
apps/desktop/src/panels/**andapps/desktop/src/components/**. - GitHub automation and contributor-facing repository policy files are isolated under
.github/**. - Media dependency setup is isolated from app code under
crates/media/**.
Routing table
apps/api/**-> docs/api-worker.md- apps/…/router.tsx -> docs/web-app-shell-routing.md
- apps/…/routeTree.gen.ts -> docs/web-app-shell-routing.md
- apps/…/__root.tsx -> docs/web-app-shell-routing.md
- apps/…/index.tsx -> docs/web-app-shell-routing.md
- apps/…/styles.css -> docs/web-app-shell-routing.md
apps/web/public/**-> docs/web-app-shell-routing.md- apps/…/*.json -> docs/web-app-shell-routing.md
- apps/…/*.ts -> docs/web-app-shell-routing.md
- apps/…/*.jsonc -> docs/web-app-shell-routing.md
- apps/…/moon.yml -> docs/web-app-shell-routing.md
- apps/…/editor.tsx -> docs/web-editor-route.md
apps/web/src/hooks/**-> docs/web-editor-route.mdapps/web/src/lib/**-> docs/web-editor-route.mdapps/web/src/components/**-> docs/web-ui-components.md- apps/…/components.json -> docs/web-ui-components.md
- apps/…/main.rs -> docs/desktop-shell.md
- apps/…/shell.rs -> docs/desktop-shell.md
- apps/…/theme.rs -> docs/desktop-shell.md
- apps/…/Cargo.toml -> docs/desktop-shell.md
- apps/…/moon.yml -> docs/desktop-shell.md
- apps/…/README.md -> docs/desktop-shell.md
apps/desktop/src/panels/**-> docs/desktop-panels.mdapps/desktop/src/components/**-> docs/desktop-ui-components.mdcrates/media/**-> docs/media-setup.md- README.md -> docs/workspace-tooling.md
- Cargo.toml -> docs/workspace-tooling.md
- Cargo.lock -> docs/workspace-tooling.md
- bunfig.toml -> docs/workspace-tooling.md
- moon.yml -> docs/workspace-tooling.md
.moon/**-> docs/workspace-tooling.md.prototools-> docs/workspace-tooling.md.tokeignore-> docs/workspace-tooling.md.vscode/**-> docs/workspace-tooling.md.gitignore-> docs/workspace-tooling.md- .env.example -> docs/workspace-tooling.md
.github/workflows/**-> docs/ci-release-flows.md- .github/pull_request_template.md -> docs/ci-release-flows.md
.github/ISSUE_TEMPLATE/**-> docs/ci-release-flows.md- .github/CODE_OF_CONDUCT.md -> docs/ci-release-flows.md
- .github/SECURITY.md -> docs/ci-release-flows.md
- .github/SUPPORT.md -> docs/ci-release-flows.md
brand/**-> docs/brand-and-changelog.mdchangelog/**-> docs/brand-and-changelog.mdLICENSE-> docs/brand-and-changelog.md- any new web route or router change -> docs/web-app-shell-routing.md
- any change to the browser editor screen flow -> docs/web-editor-route.md
- any change to desktop shell layout, theme, or app startup -> docs/desktop-shell.md
- any change to desktop panel behavior -> docs/desktop-panels.md
- any change to media dependency setup or FFmpeg metadata -> docs/media-setup.md
- any change to CI checks or repository automation -> docs/ci-release-flows.md