# NebulaOS

A Linux desktop environment built around a custom compositor, shell, and service stack.

## Structure

| Path | Purpose |
|------|---------|
| `core/nebula-core` | Core runtime and platform APIs |
| `compositor/` | Compositor configuration (Sway) |
| `shells/` | Desktop and bigscreen shell implementations |
| `packages/` | Shared UI libraries, icons, API, and design tokens |
| `services/` | System services (audio, network, bluetooth, power, accounts) |
| `session/` | Session manager and desktop entry |
| `packaging/` | Distribution packaging (Ubuntu) |
| `branding/` | Boot assets, wallpapers, and sounds |

## Getting started

Documentation and build instructions will be added as components land.