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
.prototoolschanges 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/*orcrates/*, update .moon/workspace.yml; otherwise Moon commands such as the README'smoon run web:dev,moon run api:dev, andmoon run desktop:devwill 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/desktopparticipates in the Rust workspace even thoughcrates/*is reserved in Moon project discovery. - If moon.yml
upload-logoschanges its required environment variables, remote bucket target, or input files, update .env.example and the taskinputstogether; the script sources .env.local directly and only enforcesR2_BUCKETat 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 -aand then runs Wrangler against a remote R2 bucket. If .env.local is missing orR2_BUCKETpoints at the wrong bucket,upload-logoseither exits before upload or writes every SVG inbrand/marks/to the wrong remote target. .gitignoreignoresdocs/at the repository root. If source-controlled project documentation is later added underdocs/, it will be silently untracked unless this ignore rule is narrowed or removed.