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

docs / workspace-tooling


covers:

  • README.md
  • Cargo.toml
  • Cargo.lock
  • bunfig.toml
  • moon.yml
  • .moon/**
  • .prototools
  • .tokeignore
  • .vscode/**
  • .gitignore
  • .env.example

Workspace Tooling

Overview

The repository is organized as a Moon workspace with JavaScript/TypeScript apps and Rust crates under shared root-level tooling. README.md is the developer entrypoint: it tells contributors to install Proto, run proto use from the repo root, and then start app tasks through Moon (moon run web:dev, moon run api:dev, and moon run desktop:dev). The pinned toolchain source is .prototools, which locks Moon to 2.3.3, Bun to 1.3.11, and Rust to 1.97.0 for both developer machines and CI-style environments that honor Proto.

Moon discovers projects through .moon/workspace.yml. Its projects.globs include apps/* and crates/*, and projects.sources.root maps the repository root itself as a Moon project source. Root-level Moon tasks live in moon.yml; the only root task currently defined is upload-logos, a non-cacheable, non-CI task that loads .env.local, requires R2_BUCKET, and uploads brand/…/*.svg to Cloudflare R2 by invoking bun run --cwd apps/web wrangler r2 object put. The task declares brand/…/*.svg, apps/…/package.json, and .env.example as inputs so Moon knows what should invalidate the task even though caching is disabled.

JavaScript tooling is standardized on Bun. .moon/toolchains.yml sets the JavaScript package manager to bun, pins Bun to 1.3.11, and enables Rust tooling with Moon's default Rust integration. bunfig.toml adds a repository-wide install policy: Bun will only install package versions whose release age is at least seven days (minimumReleaseAge = 604800), reducing exposure to freshly published packages. The root .gitignore keeps node_modules/, dist/, and Moon's .moon/cache/ out of version control.

Rust workspace configuration is centralized in Cargo.toml. The workspace uses resolver 3, has apps/desktop as its active member, leaves crates/* commented for future expansion, and applies workspace package defaults of version 0.1.0, edition 2024, and MIT licensing. Cargo.toml also defines gpui = "0.2.2" as a workspace dependency; Cargo.lock confirms the current Rust package graph includes opencut-desktop version 0.1.0 depending on gpui.

Shared developer configuration is intentionally small. .vscode/settings.json sets Prettier as the default formatter for general web file types, switches TypeScript and TypeScript React formatting to Biome, uses the workspace TypeScript SDK from node_modules/typescript/lib, enables format-on-save/paste, and runs Biome fix-all and import organization actions explicitly on save. .tokeignore excludes generated or high-volume artifacts such as JSON, SVG/XML, lockfiles, dist, build, and node_modules from token-oriented tooling. .gitignore ignores local environment files (.env, .env.*) while allowing .env.example, and also ignores the repository docs/ directory.

Coupling

  • If .prototools changes Bun, Moon, or Rust versions, also check .moon/toolchains.yml; Proto installs the pinned tools, while Moon uses .moon/toolchains.yml to decide how workspace tasks execute.
  • If apps or crates move outside apps/* or crates/*, update .moon/workspace.yml; otherwise Moon commands such as the README's moon run web:dev, moon run api:dev, and moon run desktop:dev will not discover the moved project.
  • If the desktop Rust package moves or additional Rust crates become active, update Cargo.toml workspace members and regenerate Cargo.lock; currently only apps/desktop participates in the Rust workspace even though crates/* is reserved in Moon project discovery.
  • If moon.yml upload-logos changes its required environment variables, remote bucket target, or input files, update .env.example and the task inputs together; the script sources .env.local directly and only enforces R2_BUCKET at runtime.
  • If formatter or lint tooling changes in package-level configs, verify .vscode/settings.json; editors currently run Biome actions for TypeScript saves while Prettier remains the default formatter for several non-TypeScript web file types.

Risks

  • moon.yml loads .env.local with shell set -a and then runs Wrangler against a remote R2 bucket. If .env.local is missing or R2_BUCKET points at the wrong bucket, upload-logos either exits before upload or writes every SVG in brand/marks/ to the wrong remote target.
  • .gitignore ignores docs/ at the repository root. If source-controlled project documentation is later added under docs/, it will be silently untracked unless this ignore rule is narrowed or removed.