# Claymorphism — AI design spec

> Soft 3D effect, rounded, inset shadows.
>
> Style page: https://www.aiwebstyle.com/styles/claymorphism.html · Live preview: https://www.aiwebstyle.com/previews/claymorphism.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

Note: The key to Claymorphism is the clever use of inner and outer shadows and very rounded corners. Adjusting the color, blur, and offset of the shadows can create different 'clay' textures.

## 2. Tokens

### Page surface

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

### Text

| Token | Value | Purpose |
|---|---|---|
| `--text-color` | `var(--clay-text)` | Body text |
| `--heading-color` | `var(--clay-heading)` | Headings |

### Links

| Token | Value | Purpose |
|---|---|---|
| `--link-color` | `var(--clay-heading)` | Link and inline accent |
| `--link-hover-color` | `var(--clay-accent)` | Link hover |

### Borders

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

### Cards

| Token | Value | Purpose |
|---|---|---|
| `--card-bg` | `var(--clay-bg)` | Card surface |
| `--card-border-radius` | `20px` | Card corner radius |
| `--card-shadow` | `var(--clay-shadow-outset)` | Card at rest |
| `--card-hover-shadow` | `var(--clay-shadow-outset-hover)` | Card on hover |

### Header

| Token | Value | Purpose |
|---|---|---|
| `--header-bg` | `var(--clay-bg)` | Sticky header surface |
| `--header-text-color` | `var(--clay-heading)` | Header text and nav links |
| `--header-shadow` | `var(--clay-shadow-outset)` | Header elevation (usually `none`) |

### Footer

| Token | Value | Purpose |
|---|---|---|
| `--footer-bg` | `var(--clay-bg)` | Footer surface |
| `--footer-text-color` | `var(--clay-text)` | Footer text |

### Buttons

| Token | Value | Purpose |
|---|---|---|
| `--button-bg` | `#c8a078` | Primary button fill |
| `--button-text-color` | `#ffffff` | Primary button label |
| `--button-hover-bg` | `#b89068` | Primary button hover fill |
| `--button-border` | `none` | Primary button border |
| `--button-secondary-bg` | `#f5e6d5` | Secondary button fill |
| `--button-secondary-text-color` | `#8b5e3c` | Secondary button label |
| `--button-secondary-hover-bg` | `#ffffff` | Secondary button hover fill |

### Code / prompt block

| Token | Value | Purpose |
|---|---|---|
| `--prompt-bg` | `var(--clay-bg)` | Code / prompt block surface |
| `--prompt-text-color` | `var(--clay-text)` | Code / prompt block text |
| `--prompt-shadow` | `var(--clay-shadow-inset)` | Code / prompt block elevation |

### Type

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

### Other tokens in this theme

| Token | Value |
|---|---|
| `--clay-bg` | `#e8c3a0` |
| `--clay-text` | `#7a6f5a` |
| `--clay-heading` | `#6b5e3c` |
| `--clay-accent` | `#b89068` |
| `--clay-highlight-for-text` | `rgba(255,255,255,0.5)` |
| `--clay-shadow-color-dark` | `rgba(0, 0, 0, 0.1)` |
| `--clay-shadow-color-light` | `rgba(255, 255, 255, 0.7)` |
| `--clay-shadow-inset` | `inset 2px 2px 5px var(--clay-shadow-color-dark),
                         inset -3px -3px 7px var(--clay-shadow-color-light)` |
| `--clay-shadow-outset` | `3px 3px 5px var(--clay-shadow-color-dark),
                          -3px -3px 7px var(--clay-shadow-color-light)` |
| `--clay-shadow-outset-hover` | `5px 5px 10px var(--clay-shadow-color-dark),
                                -5px -5px 10px var(--clay-shadow-color-light)` |
| `--button-shadow` | `var(--clay-shadow-outset)` |
| `--button-hover-shadow` | `var(--clay-shadow-outset-hover)` |
| `--button-secondary-border` | `none` |
| `--button-secondary-shadow` | `var(--clay-shadow-outset)` |
| `--button-border-radius` | `15px` |

## 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 UI elements (buttons, cards) using claymorphism. Use soft, rounded shapes, light background colors (like #e0e5ec), and inner/outer shadows to create a fluffy, clay-like 3D effect.
```

---

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