# Nibiru Atelier — Design System

The visual language of the Nibiru framework. A lotus on cream paper, lit by morning light.

## What's here

| File | Purpose |
|---|---|
| `tokens.json` | Source of truth, [W3C Design Tokens Community Group](https://design-tokens.github.io/community-group/format/) format. |
| `tokens.css` | CSS custom properties, namespaced `--nibiru-*`. |
| `tokens.scss` | SCSS variables and maps. |
| `tailwind.preset.js` | Tailwind preset extending colours, fonts, shadows. |

## Use

### CSS

```html
<link rel="stylesheet"
      href="https://nibiru-framework.com/design-system/tokens.css">
<style>
  body  { background: var(--nibiru-paper); color: var(--nibiru-ink);
          font-family: var(--nibiru-font-text); }
  h1    { font-variation-settings: var(--nibiru-fv-display-hero);
          letter-spacing: var(--nibiru-tracking-display); }
  .cta  { background: var(--nibiru-ink); color: var(--nibiru-paper);
          padding: 0.7rem 1.2rem;
          border-radius: var(--nibiru-radius-md); }
</style>
```

### Tailwind

```jsx
<button className="bg-nibiru-ink text-nibiru-paper px-5 py-2 rounded-md font-display tracking-body">
  Read the docs
</button>

<h1 className="text-hero text-nibiru-ink tracking-display">
  Create. Invent. <em className="text-nibiru-iris-deep">Impress.</em>
</h1>
```

## Full guide

→ <https://nibiru-framework.com/en/design/overview/>

## Versioning

`4.0.0` — **Cosmos**. Dark-first AI-framework brand. Magenta-amber-blue nebula
palette on a deep-space body, Space Grotesk display + Inter Tight body +
JetBrains Mono. Light "paper" surfaces still available via `.alt` sections for
content-heavy reading.

`3.0.0` — **Atelier × Cosmos**. Reconciles the editorial atelier (paper-and-ink)
with a modern AI-tool dialect: warmer butter page (`#fdf6df`), Geist type,
rounder surfaces (8–16 px), plus a dark cosmic sub-palette and a code surface
stack for hero / chat / code-card components.

`2.0.0` — Atelier release. Lotus-violet, sky-blue and warm-cream system drawn
from the actual brand mark. Bricolage Grotesque, editorial radii.
