# Grunge Style — AI design spec

> Uses dirty textures, irregular layouts, dark tones, and handwritten or distressed fonts.
>
> Style page: https://www.aiwebstyle.com/styles/grunge.html · Live preview: https://www.aiwebstyle.com/previews/grunge.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

Grunge design originated in the music and subculture scenes of the 90s. Its visual characteristics are often deliberately rough, messy, imperfect, and even somewhat 'dirty' or 'destructive'. It opposes clean, refined design, pursuing a raw, authentic, unembellished aesthetic.

## 2. Tokens

### Page surface

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

### Text

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

### Links

| Token | Value | Purpose |
|---|---|---|
| `--link-color` | `#a52a2a` | Link and inline accent |
| `--link-hover-color` | `#cd5c5c` | Link hover |

### Borders

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

### Cards

| Token | Value | Purpose |
|---|---|---|
| `--card-bg` | `#4a4a4a` | Card surface |
| `--card-border-radius` | `3px` | Card corner radius |
| `--card-shadow` | `2px 2px 5px rgba(0,0,0,0.3)` | Card at rest |
| `--card-hover-shadow` | `3px 3px 7px rgba(0,0,0,0.4)` | Card on hover |

### Header

| Token | Value | Purpose |
|---|---|---|
| `--header-bg` | `#2a2a2a` | Sticky header surface |
| `--header-text-color` | `#aaa` | Header text and nav links |
| `--header-shadow` | `inset 0 -2px 4px rgba(0,0,0,0.4)` | Header elevation (usually `none`) |

### Footer

| Token | Value | Purpose |
|---|---|---|
| `--footer-bg` | `#3a3a3a` | Footer surface |
| `--footer-text-color` | `#888` | Footer text |

### Buttons

| Token | Value | Purpose |
|---|---|---|
| `--button-bg` | `#8b0000` | Primary button fill |
| `--button-text-color` | `#ccc` | Primary button label |
| `--button-hover-bg` | `#a52a2a` | Primary button hover fill |
| `--button-border` | `1px solid #777` | Primary button border |
| `--button-secondary-bg` | `#333` | Secondary button fill |
| `--button-secondary-text-color` | `#aaa` | Secondary button label |
| `--button-secondary-hover-bg` | `#555` | Secondary button hover fill |

### Code / prompt block

| Token | Value | Purpose |
|---|---|---|
| `--prompt-bg` | `rgba(0,0,0,0.2)` | Code / prompt block surface |
| `--prompt-text-color` | `#aaa` | Code / prompt block text |

### Type

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

### Other tokens in this theme

| Token | Value |
|---|---|
| `--grunge-texture` | `url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='50' height='50' viewBox='0 0 50 50'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.7' numOctaves='10' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.07'/%3E%3C/svg%3E")` |
| `--card-bg-image` | `var(--grunge-texture)` |
| `--button-secondary-border` | `1px solid #666` |
| `--prompt-bg-image` | `none` |
| `--button-border-radius` | `2px` |

## 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
Design a grunge-style band website. Use distressed paper or concrete textures, ripped edges, layered elements, maybe some 'dirty' brush strokes, dark colors (browns, greys, muted reds), and a typewriter or stencil font.
```

---

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