A self-hosted, modular, dockerized productivity suite — a sovereign alternative to Google Workspace / Microsoft 365 that your organization deploys and fully controls.
Nébula is not a single application: it is an ecosystem of independent apps that share identity, storage, search, and notifications through a common core. Each app can be deployed alone or as part of the suite.
| App | Replaces | What it does | Phase |
|---|---|---|---|
| Atlas | Google Admin / Entra ID | Identity, SSO (OIDC), users, organizations, roles, audit | F0 |
| Helios | Workspace launcher | Central dashboard, app launcher, global search, notifications | F1 |
| Vega | Drive / OneDrive | File storage, sync, versioning, and sharing | F1 |
| Lyra | Docs / Word | Real-time collaborative document editor | F2 |
| Orión | Sheets / Excel | Spreadsheets | F3 |
| Aurora | Slides / PowerPoint | Presentations | F3 |
| Cosmos | Notion / Confluence | Notes, wiki, knowledge base | F2 |
| Pulsar | Slack / Teams | Real-time chat and messaging | F4 |
| Iris | Gmail / Outlook | F4 | |
| Cronos | Calendar | Calendar and scheduling | F4 |
| Quásar | Meet / Zoom | Video calls and conferencing | F5 |
| Núcleo | (infra) | Shared services: auth tokens, search, notifications, audit log, feature flags, event bus | F0 |
| Órbita | (infra) | Observability: metrics, logs, traces, alerts | F0 |
The naming theme is astronomical: the suite is a nebula (the cloud stars are born from), and each app is a star or celestial body. See
docs/01-naming.mdfor the full rationale and alternatives.
- Vision, goals, and non-goals
- Naming and branding
- Architecture
- Tech stack and build-vs-buy decisions
- Security
- Roadmap by phases (F0–F6)
- Monorepo folder structure
- Infrastructure (Docker / Kubernetes / observability)
- Testing strategy
- Getting started with Claude Code (F0 task plan)
- Per-service specs →
docs/services/ - Architecture Decision Records →
docs/adr/
Also see CLAUDE.md — the context file Claude Code reads automatically.
# 1. Generate the real monorepo structure from this documentation
./scaffold.sh
# 2. Copy environment variables
cp .env.example .env
# 3. Start dependencies (DB, MinIO, NATS, Meilisearch, Keycloak...)
docker compose -f infra/compose/deps.yml up
# 4. Open Claude Code in this folder and follow docs/09-getting-started.md📐 Architecture phase, entering F0. This repository contains the complete design. Code is built following the roadmap, phase by phase, starting with Núcleo + Atlas + Vega (the MVP). Begin with docs/09-getting-started.md.