Introducing a new way to review your PRs.

Read the announcement

opencut-app / opencut

The open-source CapCut alternative

View on GitHub

12 documents · Updated Nov 16, 2026

overview

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/media setup files.

Codebase-wide invariants

  • Product code is partitioned by top-level workspace area: deployable apps live under apps/*, while reusable/support crates live under crates/*.
  • 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/** and apps/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