corpus-miam-da3-beurre

DESIGN.md

Narrative design system document — paste directly into Claude Code, Cursor, or Bolt.

---
version: alpha
name: corpus-miam-da3-beurre
description: "Light product system built on #f8f8f8 with #c8fa96 as the primary CTA accent. Type anchored in system-ui at 48px / weight 600. Extracted from a corpus of screenshots — colors measured at the pixel (dominant palette + an HLS 'vivid' pass that recovers low-surface brand accents); type sizes not measured. No getComputedStyle()."
narrative: |
  corpus-miam-da3-beurre is built on a pure-white canvas (rgb(248, 248, 248)).
  The system uses rgb(200, 250, 150) as the accent for primary actions and brand signals.
  Moderately rounded CTAs (12px) — modern SaaS standard, neither sharp nor pill alongside system-ui as the primary typeface.
  Depth comes from borders and surface contrast rather than shadows — a flat, structural elevation model.

colors:
  background: "#f8f8f8"
  surface-1: "#f8f0e8"
  surface-2: "#f0e8e0"
  ink-subtle: "#181018"
  primary: "#c8fa96"
  on-primary: "#111111"
  primary-hover: "#f6db9c"
  hairline: "#908078"

typography:

rounded:
  none: 0px
  xs: 4px
  sm: 8px
  md: 14px
  lg: 20px
  xl: 32px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 4px
  sm: 8px
  md: 12px
  lg: 24px
  xl: 32px
  xxl: 64px

components:


extracted_at: "2026-06-14T04:25:14.597Z"
completeness: 28
scoreVersion: "v2"

---

# Design System — corpus-miam-da3-beurre
> Extracted automatically by Prism from corpus://corpus-miam-da3-beurre
> Date: 2026-06-14
> Viewport: Desktop 884x1848 + Mobile 390x844
> Values are extracted, not hand-written: measured at the pixel from a corpus of screenshots (dominant palette + a 2nd HLS "vivid" pass that recovers low-surface brand accents); font sizes are NOT measured (no getComputedStyle).


## 0. Design DNA

**Density**: moderate  |  **Motion**: still  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#f8f8f8` |
| Type posture | sans-led (system-ui) | display type |
| Color assertion | dual-accent | #c8fa96 |
| Whitespace | moderate | section rhythm 48px |
| Interaction | still | 0 keyframes, 0 transitions |
| Radius language | 8px-rounded | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · 8px-rounded · still-motion`

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(248, 248, 248)` is the page background. Every component composits against this.
> - **Accent**: `rgb(200, 250, 150)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 48px between major bands. Card padding: 24px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
> - **Forbidden**: Do NOT introduce heavy box-shadows — this system relies on borders for separation
>
> **Before generating UI**: import this DESIGN.md, scan §2 (Color Palette) + §4 (Components) + §10 (Agent Guide). Skip §11–12 unless extending.

## 1. Visual Theme & Atmosphere

corpus-miam-da3-beurre sits on a off-white canvas (`#f8f8f8`), a neutral foundation calibrated for sustained reading and component contrast. 

The system font stack (system-ui) trades brand voice for performance and platform familiarity. 

Body text reads in Pure Black (`#000000`) (contrast ratio 20.5:1, well above WCAG AA). **#c8fa96** (`#c8fa96`) provides interactive distinction without visual aggression. Shadow is absent by design — depth is conveyed through borders, spacing, and color differentiation rather than light simulation. 


**Key Characteristics:**
- Background: Off-White (`#f8f8f8`)
- Accent: #c8fa96 (`#c8fa96`)

## 2. Color Palette & Roles

### Background & Surface
- **Off-White** (`#f8f8f8`): Page background (primary)
- **#c8fa96** (`#c8fa96`): Surface / elevated background
- **#f6db9c** (`#f6db9c`): Surface / elevated background
- **Warm Cream** (`#f8f0e8`): Surface / elevated background
- **Beige** (`#f0e8e0`): Surface / elevated background

### Text & Content
- **Pure Black** (`#000000`): Primary body text
- **Warm Brown** (`#3e271f`): Secondary text
- **Charcoal** (`#1c2b43`): Secondary text
- **Near-Black** (`#181018`): Secondary text
- **Pure Black** (`#080810`): Secondary text

### Accent & Interactive
- **Gold** (`#fde801`): Interactive / accent
- **#d07410** (`#d07410`): Interactive / accent
- **Amber** (`#fdab05`): Interactive / accent
- **#563c1e** (`#563c1e`): Interactive / accent
- **Medium Gray** (`#908078`): Interactive / accent
- **Stone** (`#887870`): Interactive / accent

### Border & Divider
- **Beige** (`#e8e0d8`): Borders / dividers

### Full Extracted Palette
**18 colors rendered on the page**. (17 categorized above + 1 additional below.)
Colors are measured at the pixel from a corpus of screenshots (dominant palette + a 2nd HLS "vivid" pass that recovers low-surface brand accents); font sizes are NOT measured (no getComputedStyle). Color **names** are nearest-neighbor labels (no brand CSS variables to read) — treat them as deduced, not declared. Third-party logo colors are filtered out.

- `#403840` — Charcoal

## 3. Typography Rules

### Font Families

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|

## 4. Component Stylings

## 5. Layout Principles

### Layout Type
**top-nav + content**

### Grid
Single column, centered content

### Max Width
1200px

### Spacing System
Compact spacing — information density prioritized

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 12px |
| base | 16px |
| lg | 24px |
| xl | 32px |
| 2xl | 48px |
| 3xl | 64px |

### Border Radius Scale
| Name | Value | Use |
|------|-------|-----|
| None | 0px | No rounding |
| Xs | 4px | Tiny corners (badges, micro elements) |
| Sm | 8px | Buttons, inputs, small elements |
| Md | 14px | Cards, containers |
| Lg | 20px | Large rounded elements, pill segments |
| Xl | 32px | Category strips, featured containers |
| Full | 9999px | Pills, avatars, circular elements |

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Page Body | `0px` |

**Shape Personality**: Sharp & Angular — No rounding. Precise, editorial, enterprise feel.


## 5b. Spacing Rhythm Names

*Named spacing tokens with explicit use cases. Use these names in YOUR code instead of raw pixels for consistency.*

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `64px` | Top/bottom of full-bleed hero sections |
| **section** | `32px` | Between major bands (color change, content shift) |
| **subsection** | `24px` | Within a section, between content groups |
| **card** | `12px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `4px` | Icon-text gap, tag inner padding |

**Agent rule**: NEVER hardcode raw pixel values for spacing in generated UI. Always reference these named tokens (`spacing-rhythm.section`, etc.).

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |

**Shadow Philosophy**: Flat design — no shadows used. Borders and spacing define structure.

## 8. Do's and Don'ts

### Do
- Use Off-White (`#f8f8f8`) as the page background — it's intentionally not pure white
- Keep font weights between 400-400 — the system uses a narrow weight range for subtle hierarchy
- Use #c8fa96 (`#c8fa96`) as the primary accent — it's the brand's signature interactive color
- Respect the 4px–32px spacing range — the design uses a wide scale for visual breathing room

### Don't
- Don't use pure white (`#ffffff`) as a page background — the warm tone is part of the brand identity
- Don't use weight 700 (bold) or above — 400 is the maximum weight in this system
- Don't introduce additional saturated accent colors — the palette is intentionally controlled


## 7b. Enforceable Brand Rules

*Structured Do/Don't with reasoning and validation tests. Agents can programmatically verify generated UI.*

```yaml
rules:
  - id: brand-canvas-001
    type: do
    rule: "Always use the page background `rgb(248, 248, 248)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(248, 248, 248)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(200, 250, 150)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(200, 250, 150)\"]').length <= 3 per fold"
  - id: brand-depth-001
    type: dont
    rule: "Do NOT introduce drop shadows on cards or sections"
    why: "Containment is achieved via borders, not elevation — adding shadows breaks the depth contract"
    test: "getComputedStyle(card).boxShadow === 'none'"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 640px | Single column layout |
| Tablet | 768px | 2-column grids |
| Desktop | 1024px | Full layout |
| Large Desktop | 1280px | Maximum width |

### Collapsing Strategy
- Navigation: horizontal links → hamburger menu on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 0px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

## 10. Agent Prompt Guide

### Quick Reference
- Background: Off-White (`#f8f8f8`)
- Primary text: Pure Black (`#000000`)
- Accent: #c8fa96 (`#c8fa96`)
- Border: Medium Gray (`#908078`)
- Font: system-ui
- Body: 16px weight 400

### Example Component Prompts
- "Create the primary CTA button: `#c8fa96` background, `#000000` text, 12px border-radius, 11px 21px padding, 700 weight, system-ui font."
- "Build navigation: sticky on `#f8f8f8`. system-ui 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Off-White (`#f8f8f8`) — every component is composited against this exact base.
2. **Typography**: All type in system-ui, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: #c8fa96 (`#c8fa96`) — one accent, applied consistently to CTAs, active states, and links. Never introduce a second saturated color.
4. **Spacing**: Use the `--ca-space-*` token scale (4px–32px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
5. **Tokens**: Import from §11 CSS Export (`--ca-*` vars). Never hardcode hex values — always reference a token so theming remains consistent.

## 11. CSS Design Tokens Raw Export

*Copy-paste ready `:root {}` block — all values extracted directly from the live site.*

```css
/* Colors */
:root {
  --ca-background: #f8f8f8;
  --ca-surface-1: #f8f0e8;
  --ca-surface-2: #f0e8e0;
  --ca-ink-subtle: #181018;
  --ca-primary: #c8fa96;
  --ca-on-primary: #111111;
  --ca-primary-hover: #f6db9c;
  --ca-hairline: #908078;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 4px;
  --ca-space-sm: 8px;
  --ca-space-md: 12px;
  --ca-space-base: 16px;
  --ca-space-lg: 24px;
  --ca-space-xl: 32px;
  --ca-space-2xl: 48px;
  --ca-space-3xl: 64px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 4px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 14px;
  --ca-radius-lg: 20px;
  --ca-radius-xl: 32px;
  --ca-radius-full: 9999px;
}
```


---
## Coverage: 28% of dimensions extracted

> Coverage measures how much of the design we could read, **not** how pixel-faithful a clone is. For fidelity, see the SSIM/structure score.

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 24 | 25 | 17 named colors |
| Typography | 0 | 20 | 0 roles defined |
| Components | 0 | 20 | 0 specs extracted |
| Motion & Interaction | 0 | 15 | No keyframes |
| CSS Custom Properties | 0 | 10 | 0 vars |
| Responsive Breakpoints | 4 | 5 | 4 breakpoints |
| Variable Fonts | 0 | 5 | None detected |

## 12. Known Gaps & Confidence

Explicit list of what this extraction could NOT capture. Agents should not invent values for these — either skip the feature or use the documented baseline + heuristic fallback.

*Auto-detected extraction limitations — understand before building:*

- **Sparse component extraction** — fewer than 5 component types detected. Highly dynamic sections (modals, datepickers, carousels) require interaction to render and are not captured in a static pass.

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Photography** | No photographic content detected on this page | Don't add stock imagery; clarity comes from type + color blocks |
| **Motion / Animation** | No @keyframes or transitions detected | Either keep clones strictly static, or apply a single 150ms ease-out on hover/focus universally |
| **Component states** | Hover / focus / active states not captured | Darken background ~10% on hover, add 2px focus ring matching accent token, +50% opacity for disabled |
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |
| **Form inputs** | No text input fields detected on this page | Use the documented border-radius + accent border on focus; 12-16px padding inside |
| **Design tokens** | Only 0 CSS custom properties (low signal for semantic naming) | Color names are nearest-neighbor approximations; verify against brand guidelines if available |

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg measured at the pixel |
| §2 Colors | Low | 0 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | Low | 0 typography roles inferred |
| §4 Components | Low | 0 component variants captured |
| §7 Motion | Low | No motion data |
| §8 Do's/Don'ts | Medium | 7 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 4 breakpoints detected |
| §9b Photography | Low | 0 images, hero not detected |

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: corpus://corpus-miam-da3-beurre | 2026-06-14T04:25:14.601Z*
*Values measured at the pixel from a corpus of screenshots (dominant palette + a 2nd HLS "vivid" pass that recovers low-surface brand accents); font sizes are NOT measured (no getComputedStyle). Cross-check against the live build before shipping.*