# @nebula/core-theme

Theme tokens tuned for readable, couch-friendly UI. Exports plain objects and helpers only.

## What it does

- Provides a default token set for colors, spacing, typography, radius, and motion.
- Lets you merge overrides with `createTheme()` for custom styling.
- Keeps everything as plain objects for easy use in any UI layer.

## Token groups

- **colors**: Background, surface, text, accent, focus, danger.
- **spacing**: XS through XXL spacing scale.
- **radius**: Corner radius presets.
- **typography**: Caption, body, title, display sizes.
- **motion**: Fast/base/slow durations.

## Typical use cases

- Consistent visual system across packages and apps.
- Theme customization without framework coupling.
- Readable defaults for TV and handheld screens.
