Sunbeam Studios Monorepo

A self-hosted cooperative studio shipping its own platform, agents, apps, game engine, and AI tooling from a single Rust-flavored monorepo.

What lives here

Directory	Contents
platform/	Core infrastructure: WFE workflow engine, CLI, HTTP proxy, Sol AI agent
apps/	User-facing products: driver, kanban, sunbeam-meet, kratos-admin, site, typst-editor, estafeta
libs/	Shared libraries: beam-ui (React), beam-ui-typst, storybook, mistralai-client-rs, sunbeam-dg (discrete global grid), mcp-server
engines/	Game engines: marathon (Bevy + iroh)
infra/	Deployment: sbbb kustomize manifests and infrastructure configuration
owned-forks/	Permanent forks: tuwunel (Matrix homeserver), forgejo, penpot, penpot-mcp
3p/	Upstream Rust libraries as submodules: tokio, mio, pingora
forks/	Service forks as submodules: kratos, keto, hydra, headscale, tailscale, element-call, element-desktop, bulwark, polis
research/	Exploration: dirt, demikernel

Getting started

git clone --recursive https://src.sunbeam.pt/studio/sunbeam
cd sunbeam
direnv allow
cargo check --workspace --exclude tuwunel

Platform support

Development targets macOS and Linux only. Windows is an end-user deployment target (SBBB desktop shell, Tauri applications) but not a contributor environment.

Git hosting

The entire development lifecycle — issues, pull requests, CI, releases — runs on the Sunbeam Gitea at src.sunbeam.pt. Any presence elsewhere (GitHub, Codeberg, etc.) is a one-way mirror from there, not a fork to contribute against.

Workspace management

The sunbeam CLI (from platform/cli) provides workspace and worktree management. See docs/CONTRIBUTING.md for contributor workflows.

Licensing

Each project in this monorepo carries its own license. There is no single workspace-wide license. See the LICENSE (or LICENSE.md) file at the root of each project directory (e.g., platform/cli/LICENSE.md, apps/sunbeam-meet/LICENSE, owned-forks/tuwunel/LICENSE). Submodules under 3p/ and forks/ carry the upstream project's license verbatim.

Next steps

• Layout details: docs/LAYOUT.md
• Monorepo configs: docs/CONFIGS.md
• Worktree system: docs/WORKTREES.md
• Project / workspace spec: docs/SPEC.md
• Contributing: docs/CONTRIBUTING.md
• Retired repository history: docs/retired-repos.md
• Architecture: (Coming soon)