# DESIGN.md — Deep Ocean

> Design context for AI coding agents. Paste this file into Cursor, Claude Code, Codex, v0 or Lovable
> before asking for UI, or commit it at your repo root as `DESIGN.md`.

- **Source:** [Deep Ocean on CSS Crème](https://csscreme.com/themes/deep-ocean)
- **Default mode:** dark
- **Tags:** dark, blue, calm
- **Install as a real shadcn/ui theme:** `npx shadcn@latest add https://csscreme.com/r/deep-ocean.json`

A restrained, professional blue palette — trustworthy without the corporate stiffness.

---

## Semantic color roles

Six roles carry the identity. Everything else in this file is derived from them.

| Role | Hex | OKLCH | Use it for |
| --- | --- | --- | --- |
| `bg` | `#071A2B` | `oklch(21.2% 0.042 247.8)` | page background |
| `surface` | `#0F2A40` | `oklch(27.6% 0.052 245.9)` | cards, panels, popovers |
| `primary` | `#36B7C2` | `oklch(71.6% 0.109 203.5)` | brand actions: primary buttons, links, focus rings |
| `accent` | `#5BA7F7` | `oklch(71.4% 0.140 251.4)` | secondary emphasis only, never a second primary |
| `text` | `#E4F1F6` | `oklch(95.0% 0.015 222.7)` | body and heading text |
| `muted` | `#7E9AAC` | `oklch(67.1% 0.041 236.4)` | secondary text, borders, disabled states |

## Full token set (shadcn/ui, both modes)

Colors are OKLCH (Tailwind v4 / shadcn native). Brand colors are identical in both modes by design:
only the neutrals move, and they keep their hue, so light and dark read as the same design system.

| Token | Light | Dark |
| --- | --- | --- |
| `--background` | `oklch(98.8% 0.002 247.8)` | `oklch(21.2% 0.042 247.8)` |
| `--foreground` | `oklch(26.9% 0.014 220.1)` | `oklch(95.0% 0.015 222.7)` |
| `--card` | `oklch(97.2% 0.003 247.9)` | `oklch(27.6% 0.052 245.9)` |
| `--card-foreground` | `oklch(26.9% 0.014 220.1)` | `oklch(95.0% 0.015 222.7)` |
| `--popover` | `oklch(97.2% 0.003 247.9)` | `oklch(27.6% 0.052 245.9)` |
| `--popover-foreground` | `oklch(26.9% 0.014 220.1)` | `oklch(95.0% 0.015 222.7)` |
| `--primary` | `oklch(71.6% 0.109 203.5)` | `oklch(71.6% 0.109 203.5)` |
| `--primary-foreground` | `oklch(15.2% 0.009 285.3)` | `oklch(15.2% 0.009 285.3)` |
| `--secondary` | `oklch(97.8% 0.003 228.8)` | `oklch(25.3% 0.050 247.7)` |
| `--secondary-foreground` | `oklch(26.9% 0.014 220.1)` | `oklch(95.0% 0.015 222.7)` |
| `--muted` | `oklch(97.8% 0.003 228.8)` | `oklch(25.3% 0.050 247.7)` |
| `--muted-foreground` | `oklch(54.0% 0.014 240.1)` | `oklch(67.1% 0.041 236.4)` |
| `--accent` | `oklch(71.4% 0.140 251.4)` | `oklch(71.4% 0.140 251.4)` |
| `--accent-foreground` | `oklch(15.2% 0.009 285.3)` | `oklch(15.2% 0.009 285.3)` |
| `--destructive` | `oklch(62.6% 0.193 23.0)` | `oklch(62.6% 0.193 23.0)` |
| `--destructive-foreground` | `oklch(15.2% 0.009 285.3)` | `oklch(15.2% 0.009 285.3)` |
| `--border` | `oklch(83.8% 0.005 247.9)` | `oklch(35.3% 0.041 242.5)` |
| `--input` | `oklch(83.8% 0.005 247.9)` | `oklch(35.3% 0.041 242.5)` |
| `--ring` | `oklch(71.6% 0.109 203.5)` | `oklch(71.6% 0.109 203.5)` |

## Typography

- **Headings:** Sora
- **Body:** Inter

## Shape and rhythm

- **Radius:** `10px` (the `--radius` token; derive smaller/larger from it, do not invent new values)
- **Spacing scale:** 4px base · 4 / 8 / 12 / 16 / 24 / 32

## Contrast, measured

Computed from the tokens above in dark mode, not asserted. Ratios are WCAG 2.1 relative luminance.

| Pair | Foreground | Background | Ratio | Verdict |
| --- | --- | --- | --- | --- |
| Body text on page background | `#E4F1F6` | `#071A2B` | 15.28:1 | AAA |
| Body text on card | `#E4F1F6` | `#0F2A40` | 12.78:1 | AAA |
| Muted text on page background | `#7E9AAC` | `#071A2B` | 5.96:1 | AA |
| Button label on primary | `#0b0b0f` | `#36B7C2` | 8.15:1 | AAA |
| Button label on accent | `#0b0b0f` | `#5BA7F7` | 7.78:1 | AAA |

## Rules for the agent

These are constraints, not suggestions. Each one is checkable against the tables above.

1. **Use only the tokens listed here.** Do not introduce a hex value that is not in the token table. If
   you need an in-between shade, mix two existing tokens rather than inventing a new hue.
2. **`#36B7C2` (primary) is the only call-to-action color.** One primary action per view. `accent`
   is for secondary emphasis and must never be styled as a second primary button.
3. **Never restyle brand colors between light and dark.** Only neutrals change mode. A theme whose
   primary shifts between modes is a different theme.
4. **Respect the radius token.** Every corner derives from `10px`. Mixed radii across a view is
   the most common tell of generated UI.
5. **Stay on the spacing scale.** 4px base · 4 / 8 / 12 / 16 / 24 / 32. No arbitrary pixel values.
6. **Do not drop below the contrast ratios above.** If a combination you need is not in the contrast
   table, compute it before shipping it. Text under 4.5:1 fails AA.
7. **Headings in Sora, body in Inter.** Do not add a third family.
8. **Use the semantic role, not the raw color.** Write `var(--primary)`, never `#36B7C2`, so the
   theme stays swappable.

## CSS variables

Paste into `globals.css`:

```css
:root {
  --background: oklch(98.8% 0.002 247.8);
  --foreground: oklch(26.9% 0.014 220.1);
  --card: oklch(97.2% 0.003 247.9);
  --card-foreground: oklch(26.9% 0.014 220.1);
  --popover: oklch(97.2% 0.003 247.9);
  --popover-foreground: oklch(26.9% 0.014 220.1);
  --primary: oklch(71.6% 0.109 203.5);
  --primary-foreground: oklch(15.2% 0.009 285.3);
  --secondary: oklch(97.8% 0.003 228.8);
  --secondary-foreground: oklch(26.9% 0.014 220.1);
  --muted: oklch(97.8% 0.003 228.8);
  --muted-foreground: oklch(54.0% 0.014 240.1);
  --accent: oklch(71.4% 0.140 251.4);
  --accent-foreground: oklch(15.2% 0.009 285.3);
  --destructive: oklch(62.6% 0.193 23.0);
  --destructive-foreground: oklch(15.2% 0.009 285.3);
  --border: oklch(83.8% 0.005 247.9);
  --input: oklch(83.8% 0.005 247.9);
  --ring: oklch(71.6% 0.109 203.5);
  --radius: 10px;
}

.dark {
  --background: oklch(21.2% 0.042 247.8);
  --foreground: oklch(95.0% 0.015 222.7);
  --card: oklch(27.6% 0.052 245.9);
  --card-foreground: oklch(95.0% 0.015 222.7);
  --popover: oklch(27.6% 0.052 245.9);
  --popover-foreground: oklch(95.0% 0.015 222.7);
  --primary: oklch(71.6% 0.109 203.5);
  --primary-foreground: oklch(15.2% 0.009 285.3);
  --secondary: oklch(25.3% 0.050 247.7);
  --secondary-foreground: oklch(95.0% 0.015 222.7);
  --muted: oklch(25.3% 0.050 247.7);
  --muted-foreground: oklch(67.1% 0.041 236.4);
  --accent: oklch(71.4% 0.140 251.4);
  --accent-foreground: oklch(15.2% 0.009 285.3);
  --destructive: oklch(62.6% 0.193 23.0);
  --destructive-foreground: oklch(15.2% 0.009 285.3);
  --border: oklch(35.3% 0.041 242.5);
  --input: oklch(35.3% 0.041 242.5);
  --ring: oklch(71.6% 0.109 203.5);
}
```

Tailwind v4 maps them into utilities:

```css
@theme inline {
  --color-background: var(--background);
  --color-foreground: var(--foreground);
  --color-card: var(--card);
  --color-card-foreground: var(--card-foreground);
  --color-popover: var(--popover);
  --color-popover-foreground: var(--popover-foreground);
  --color-primary: var(--primary);
  --color-primary-foreground: var(--primary-foreground);
  --color-secondary: var(--secondary);
  --color-secondary-foreground: var(--secondary-foreground);
  --color-muted: var(--muted);
  --color-muted-foreground: var(--muted-foreground);
  --color-accent: var(--accent);
  --color-accent-foreground: var(--accent-foreground);
  --color-destructive: var(--destructive);
  --color-destructive-foreground: var(--destructive-foreground);
  --color-border: var(--border);
  --color-input: var(--input);
  --color-ring: var(--ring);
  --radius: var(--radius);
}
```

---

Generated by [CSS Crème](https://csscreme.com) — curated web design, decoded so you can build it.
Every value above is computed from the palette, not written by hand.