# Dark Mode — AI design spec

> Dark backgrounds, light text, tech feel.
>
> Style page: https://www.aiwebstyle.com/styles/dark-mode.html · Live preview: https://www.aiwebstyle.com/previews/dark-mode.html
>
> Drop this file at the root of a project and point your coding agent at it. Every value is copied from the working stylesheet, not estimated.

## 1. What this style is

Dark Mode, also known as dark theme or night mode, is an interface color scheme that uses dark backgrounds and light foregrounds (text, icons). It contrasts with the traditional light background, dark foreground approach.

## 2. Tokens

### Page surface

| Token | Value | Purpose |
|---|---|---|
| `--page-bg` | `#121212` | Page background (solid fallback) |
| `--page-bg-gradient` | `none` | Page background gradient; overrides the solid unless `none` |

### Text

| Token | Value | Purpose |
|---|---|---|
| `--text-color` | `#e0e0e0` | Body text |
| `--heading-color` | `#ffffff` | Headings |

### Links

| Token | Value | Purpose |
|---|---|---|
| `--link-color` | `#0a84ff` | Link and inline accent |
| `--link-hover-color` | `#64d2ff` | Link hover |

### Borders

| Token | Value | Purpose |
|---|---|---|
| `--border-color` | `#333333` | Dividers and input borders |

### Cards

| Token | Value | Purpose |
|---|---|---|
| `--card-bg` | `#1e1e1e` | Card surface |
| `--card-border-radius` | `6px` | Card corner radius |
| `--card-shadow` | `0 2px 5px rgba(0,0,0,0.2)` | Card at rest |
| `--card-hover-shadow` | `0 4px 10px rgba(0,0,0,0.3)` | Card on hover |

### Header

| Token | Value | Purpose |
|---|---|---|
| `--header-bg` | `#1e1e1e` | Sticky header surface |
| `--header-text-color` | `#ffffff` | Header text and nav links |
| `--header-shadow` | `none` | Header elevation (usually `none`) |

### Footer

| Token | Value | Purpose |
|---|---|---|
| `--footer-bg` | `#121212` | Footer surface |
| `--footer-text-color` | `#aaaaaa` | Footer text |

### Buttons

| Token | Value | Purpose |
|---|---|---|
| `--button-bg` | `#0a84ff` | Primary button fill |
| `--button-text-color` | `white` | Primary button label |
| `--button-hover-bg` | `#005ecb` | Primary button hover fill |
| `--button-border` | `none` | Primary button border |
| `--button-secondary-bg` | `#333333` | Secondary button fill |
| `--button-secondary-text-color` | `#b0b0b0` | Secondary button label |
| `--button-secondary-hover-bg` | `#444444` | Secondary button hover fill |

### Code / prompt block

| Token | Value | Purpose |
|---|---|---|
| `--prompt-bg` | `#2c2c2c` | Code / prompt block surface |
| `--prompt-text-color` | `#b0b0b0` | Code / prompt block text |

### Type

| Token | Value | Purpose |
|---|---|---|
| `--base-font` | `var(--font-open-sans)` | Body font stack |
| `--heading-font` | `var(--font-open-sans)` | Heading font stack |

### Other tokens in this theme

| Token | Value |
|---|---|
| `--button-secondary-hover-text-color` | `white` |
| `--button-secondary-border` | `none` |
| `--button-border-radius` | `4px` |

## 3. Do

- Drive every color, radius and shadow from the tokens below. No literal hex values in component code.
- Reuse the `--card-*` tokens for any elevated surface (card, panel, modal, dropdown) so elevation stays consistent.
- Keep header and footer on `--header-*` / `--footer-*` even when the page background is a gradient.

## 4. Don't

- Do not blend tokens from another style in this library — one page, one token set.
- Do not invent a hover state: every interactive element has a `*-hover-*` token above.

## 5. Using this with a coding agent

Place this file at the project root as `DESIGN.md`, then instruct the agent:

> Follow `DESIGN.md` for all UI. Every color, radius and shadow comes from its token table. If you need a state that is not listed, derive it from the nearest listed token and add the new token to `DESIGN.md` instead of hard-coding a value.

If the project already has a token layer (Tailwind config, CSS custom properties, a theme file), map these tokens onto it one-to-one and keep the names unchanged.

## 6. Original prompt

```text
Create a modern dark mode theme for a tech blog. Use a deep charcoal or navy background (#1a1f2c), light grey text (#e0e0e0), a vibrant accent color (#4d5bff) for links/buttons, and Poppins font.
```

---

*Generated from the `dark-mode` theme in `style.css`. Token values are verbatim — regenerate rather than edit by hand.*