Repository layout

What's in each folder, and the commands you'll use.

plan.video is one repository: an npm workspace with the apps and packages, plus the services and the database next to them.

plan-video/
  apps/        the website
  packages/    the editor's engine and shared code
  services/    the server's services, one folder each
  supabase/    the database's migrations, email templates and tests
  scripts/     tools for installing, translating and releasing
  patches/     fixes applied to node_modules on install
  docs/        the JSX reference, examples, and brand and design notes
  assets/      the killfeed extension's game icons

Apps

FolderWhat it is
apps/webThe website, dashboard and editor. SolidJS, Vite and Tailwind CSS.

Most of the work happens in apps/web/src:

FolderWhat's in it
pagesOne file per page or route, such as login.tsx or dashboard.tsx
componentsThe UI, with a folder for each area: calendar, dashboard, timeline and more
libLogic without UI: syncing, scheduling, each network's sign-in, translations
content/docsThese docs, one Markdown file per page
localesThe translations, one JSON file per language

Packages

PackageWhat it does
runtimeThe editor's engine: the project's state, media, timing and drawing, with no UI
reconcilerTurns a project, written as JSX, into the runtime's objects
jsxThe types and functions a project is written with
encoderExports video, audio and pictures in the browser
assetsA project's files: the library, hashing and reading media details
dapiThe tools AI agents use, with their names, descriptions and schemas, shared by the Assistant and the MCP server
koota-solidSolid bindings for koota, the store the runtime is built on
agent-chatRuns Claude Code or Codex on your computer and streams them to the app
api-contractTypes for an older backend API

Services

Each folder in services/ is a small Node.js server with its systemd unit: publisher, gateway, photos, storage, mcp, agent, transcribe, billing, tiktok, youtube, linkedin and x, plus monitor, a shell script on a timer. They aren't part of the npm workspace: the five with dependencies, agent, mcp, photos, publisher and storage, have their own package.json. Services says what each does.

The dev server runs agent, transcribe, billing and the four network services itself, from the files beside apps/web/vite.config.ts, so you don't need them to develop.

Commands

CommandWhat it does
npm run dev -w @plan.video/webStarts the dev server at localhost:5173
npm run buildBuilds the website into apps/web/dist
npm run check -w @plan.video/webType-checks the website
npm testRuns the workspaces' unit tests
npm run i18nChecks the translations; see Translations