# NebulaOS Desktop Mode

NebulaOS Desktop Mode is the mouse-and-keyboard desktop layer for NebulaOS. It uses KDE Plasma as the starter foundation so the system can provide a normal Linux desktop while the Nebula-specific shell, launcher, and visual identity mature.

The repository is the source of truth. Local KDE folders under `~/.local/share` are runtime and test targets only. During development, symlinks can point KDE at the files in this repo; for packaging and install testing, use the apply script to copy the same repo files into KDE's local package locations.

## Current Customisation Layer

Starter KDE Plasma customisation currently happens through:

- Plasma desktop themes for shell surfaces such as panels, widgets, popups, dialogs, and SVG assets.
- Look-and-feel packages for grouping the desktop experience under a Nebula identity.
- Color schemes for the Nebula Dark palette.
- Plasmoids for prototype Nebula desktop widgets such as the launcher.
- Later, KWin scripts and deeper KDE source patches after this prototype layer works.

This layer should stay small and safe for now. Avoid deep KDE source changes until the Plasma theme, color scheme, look-and-feel package, and launcher prototype are easy to test and iterate.

## Useful Test Commands

```bash
kbuildsycoca6
plasmoidviewer -a org.nebula.launcher
./Desktop/scripts/reload-plasma.sh
./Desktop/scripts/apply-nebula-desktop.sh
```

`reload-plasma.sh` is for refreshing Plasma after editing symlinked repo files. `apply-nebula-desktop.sh` copies the repo packages into local KDE folders for install and packaging tests.
