Architecture

ShipCut is a Turborepo monorepo with app-specific entry points and shared media pipeline packages.

Structure

apps/
  web/              Marketing site (Next.js, also serves /docs)
  desktop/          Electron + Vite + React 19
  cli/              CLI tool (published package shape, repo-first today)
  docs/             This documentation (Nextra)
packages/
  db/               Local job persistence and settings
  media/            FFmpeg orchestration and captioned render output
  publish/          Publish handoff artifacts and browser-assist hooks
  shared/           Types, schemas, constants, design tokens
  story/            Narrative analysis and edit-plan generation
  transcript/       YouTube metadata, subtitle reuse, local ASR fallback
  ui/               Shared React primitives and icons

Pipeline shape

1. Prepare source media from YouTube or a local file
2. Resolve transcript from subtitles first, Whisper second
3. Build narrative plans for one long-form cut and multiple short cuts
4. Render outputs through FFmpeg-driven media helpers
5. Assemble publish artifacts for each target platform

Docs deployment

ShipCut uses the same docs architecture as ShipCode:

• apps/docs builds as a static Nextra site
• docs are exported with DOCS_BASE_PATH=/docs
• scripts/sync-docs-to-web.sh copies the static export into apps/web/public/docs
• Vercel deploys apps/web, which serves both the landing page and /docs