# Brutalism — AI design spec

> Raw, unpolished, high-contrast design.
>
> Style page: https://www.aiwebstyle.com/styles/brutalism.html · Live preview: https://www.aiwebstyle.com/previews/brutalism.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

Brutalism in web design originates from the architectural movement of the same name, emphasizing raw, exposed, unadorned materials and structures. It is often seen as a rebellion against current refined, sleek, user-friendly design trends.

## 2. Tokens

### Page surface

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

### Text

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

### Links

| Token | Value | Purpose |
|---|---|---|
| `--link-color` | `#0000ff` | Link and inline accent |
| `--link-hover-color` | `#ff00ff` | Link hover |

### Borders

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

### Cards

| Token | Value | Purpose |
|---|---|---|
| `--card-bg` | `#f0f0f0` | Card surface |
| `--card-border-radius` | `0px` | Card corner radius |
| `--card-shadow` | `4px 4px 0px #000000` | Card at rest |
| `--card-hover-shadow` | `6px 6px 0px #000000` | Card on hover |

### Header

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

### Footer

| Token | Value | Purpose |
|---|---|---|
| `--footer-bg` | `#f0f0f0` | Footer surface |
| `--footer-text-color` | `#000000` | Footer text |

### Buttons

| Token | Value | Purpose |
|---|---|---|
| `--button-bg` | `yellow` | Primary button fill |
| `--button-text-color` | `black` | Primary button label |
| `--button-hover-bg` | `black` | Primary button hover fill |
| `--button-border` | `2px solid black` | Primary button border |
| `--button-secondary-bg` | `black` | Secondary button fill |
| `--button-secondary-text-color` | `yellow` | Secondary button label |
| `--button-secondary-hover-bg` | `yellow` | Secondary button hover fill |

### Code / prompt block

| Token | Value | Purpose |
|---|---|---|
| `--prompt-bg` | `#e0e0e0` | Code / prompt block surface |
| `--prompt-text-color` | `#111` | Code / prompt block text |

### Type

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

### Other tokens in this theme

| Token | Value |
|---|---|
| `--button-hover-text-color` | `yellow` |
| `--button-secondary-hover-text-color` | `black` |
| `--button-secondary-border` | `2px solid black` |
| `--button-border-radius` | `0px` |

## 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 brutalist website for an art zine. Use default system fonts (Arial, Times), stark high-contrast colors (black/white or black/yellow), hard borders, no rounded corners, and maybe harsh block shadows.
```

---

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