tanstack.com

DESIGN.md

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

---
version: alpha
name: tanstack.com
description: "Light product system built on #fdfdfd with #737373 as the primary CTA accent. Type anchored in Inter at 96px / weight 900. Extracted automatically from https://tanstack.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  tanstack.com is built on a pure-white canvas (rgb(253, 253, 253)).
  The system uses rgb(115, 115, 115) as the singular interactive color.
  Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside Inter as the primary typeface.
  A layered elevation system (16 distinct shadows) building a clear front-to-back hierarchy.
  Motion is a first-class concern — 17 keyframe animations plus transition-driven interactions.

colors:
  background: "#fdfdfd"
  surface-1: "#ffffff"
  surface-2: "#f5f5f5"
  ink: "#171717"
  ink-muted: "rgba(23, 23, 23, 0.65)"
  primary: "#737373"
  on-primary: "#111111"
  primary-hover: "#784b30"
  hairline: "#e5e5e5"
  primary-focus: "#171717"

typography:
  display-xl:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 96px
    fontWeight: 900
    lineHeight: 1
    letterSpacing: 0
  display-md:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 24px
    fontWeight: 600
    lineHeight: 1.5
    letterSpacing: -0.96px
  headline:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 700
    lineHeight: 1.5
    letterSpacing: 0
  body:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  body-sm:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 400
    lineHeight: 1.43
    letterSpacing: 0
  button:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 20px
    fontWeight: 900
    lineHeight: 1.4
    letterSpacing: 0

rounded:
  none: 0px
  xs: 4px
  sm: 8px
  md: 12px
  lg: 16px
  xl: 32px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 4px
  sm: 8px
  md: 16px
  lg: 27px
  xl: 53px
  xxl: 72px

components:
  button-ghost:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 4px 0px
  button-ghost-2:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.headline}"
    rounded: "{rounded.none}"
    padding: 0px 8px 0px 4px
  button-secondary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.primary-focus}"
    typography: "{typography.body-sm}"
    rounded: "{rounded.xs}"
    padding: 6px 8px
  input-text-input:
    backgroundColor: "transparent"
    textColor: "{colors.primary-focus}"
    typography: "{typography.body-sm}"
    rounded: "{rounded.none}"
    padding: 4px 20px 16px

extracted_at: "2026-06-11T06:19:01.035Z"
completeness: 75
scoreVersion: "v2"

---

# Design System — tanstack.com
> Extracted automatically by Prism from https://tanstack.com
> Date: 2026-06-11
> Viewport: Desktop 1440x900 + Mobile 390x844
> Values are extracted, not hand-written: rendered styles via getComputedStyle() + colors declared in CSS custom properties (token-only values are marked `(token)` and may not be painted).


## 0. Design DNA

**Density**: sparse  |  **Motion**: expressive  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#fdfdfd` |
| Type posture | sans-led (Inter) | "TanStack" |
| Color assertion | dual-accent | #737373 |
| Whitespace | sparse | section rhythm 64px |
| Interaction | expressive | 17 keyframes, 13 transitions |
| Radius language | 6px-rounded | from token scale |

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

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(253, 253, 253)` is the page background. Every component composits against this.
> - **Accent**: `rgb(115, 115, 115)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 64px between major bands. Card padding: 27px.
> - **Default radius**: 8px on buttons/inputs. Pills (`9999px`) only for icon-buttons or status chips.
>
> **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

tanstack.com sits on a pure white canvas (`#fdfdfd`), a neutral foundation calibrated for sustained reading and component contrast. 

Typography is anchored in **Inter**. Headlines use weight 900 for confident, assertive presence — the brand wants to be heard. 

Body text reads in Near-Black (`#171717`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Slate Grey** (`#737373`) provides interactive distinction without visual aggression. Elevation is built from multi-layer shadow stacks (16 distinct) — each combines several blurred layers at varying offsets to build a clear front-to-back hierarchy. 
Motion design uses smooth easing curves for polished state transitions. 

**Key Characteristics:**
- Background: Pure White (`#fdfdfd`)
- Primary typeface: Inter
- Primary text: Near-Black (`#171717`)
- Accent: Slate Grey (`#737373`)
- Display: 96px weight 900
- Shadow system: 16 distinct elevation levels
- Custom fonts loaded: Inter

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#fdfdfd`): Page background (primary)
- **Whitesmoke** (`#e5e5e5`): Surface / elevated background
- **White** (`#ffffff`): Surface / elevated background
- **Off-White** (`#f5f5f5`): Surface / elevated background

### Text & Content
- **Near-Black** (`#171717`): Primary body text
- **Black** (`#000000`): Secondary text
- **Pure Black** (`#0a0a0a`): Secondary text
- **Near-Black** (`#262626`): Secondary text

### Accent & Interactive
- **#784b30** (`#784b30`): Interactive / accent
- **Ring Blue** (`#3b82f6`): Interactive / accent
- **Honey** (`#ae7d44`): Interactive / accent
- **Discord** (`#536bbd`): Interactive / accent
- **Crimson** (`#ed203d`): Interactive / accent

### Full Extracted Palette
**17 colors rendered on the page** + **12** more declared in design tokens (CSS custom properties — not necessarily painted). (13 categorized above + 16 additional below.)
Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.

- `#525252` — Charcoal
- `#a3a3a3` — Grey
- `#404040` — Charcoal
- `#737373` — Slate Grey
- `#eee6d3` — Beige *(token)*
- `#956339` — #956339 *(token)*
- `#d4d4d4` — Light Grey *(token)*
- `#321c16` — Warm Brown *(token)*
- `#f8f5ee` — Off-White *(token)*
- `#22c993` — Emerald *(token)*
- `#fafafa` — Off-White *(token)*
- `#58362b` — Dark Gray *(token)*
- `#cdac77` — #cdac77 *(token)*
- `#dfcda9` — #dfcda9 *(token)*
- `#653f2e` — #653f2e *(token)*
- `#bd9051` — Honey *(token)*

### CSS Custom Properties (Design Tokens)

**Shadow Token**
- `--tw-inset-shadow-alpha`: `100%`
- `--tw-inset-ring-shadow`: `0 0 #0000`
- `--tw-inset-shadow`: `0 0 #0000`
- `--tw-shadow-alpha`: `100%`

**Error / Destructive**
- `--color-red-900`: `oklch(39.6% .141 25.723)`
- `--color-red-300`: `oklch(80.8% .114 19.571)`
- `--color-red-600`: `oklch(57.7% .245 27.325)`
- `--color-red-200`: `oklch(88.5% .062 18.334)`

**Warning**
- `--color-yellow-400`: `oklch(85.2% .199 91.936)`
- `--color-amber-300`: `oklch(87.9% .169 91.605)`
- `--color-yellow-300`: `oklch(90.5% .182 98.111)`
- `--color-yellow-950`: `oklch(28.6% .066 53.813)`

**Success**
- `--color-green-500`: `oklch(72.3% .219 149.579)`
- `--color-green-900`: `oklch(39.3% .095 152.535)`
- `--color-green-600`: `oklch(62.7% .194 149.214)`
- `--color-green-950`: `oklch(26.6% .065 152.934)`

**Border Radius Token**
- `--radius-sm`: `.25rem`
- `--radius-2xl`: `1rem`
- `--radius-md`: `.375rem`
- `--radius-lg`: `.5rem`

**Font Weight Token**
- `--font-weight-bold`: `700`
- `--font-weight-light`: `300`
- `--font-weight-black`: `900`
- `--font-weight-semibold`: `600`

**Spacing Token**
- `--tw-space-x-reverse`: `0`
- `--spacing`: `.25rem`
- `--tw-space-y-reverse`: `0`

**Motion Token**
- `--default-transition-duration`: `.15s`
- `--default-transition-timing-function`: `cubic-bezier(.4, 0, .2, 1)`

**Other tokens**
- `--color-purple-200`: `oklch(90.2% .063 306.703)`
- `--color-twine-100`: `#eee6d3`
- `--color-zinc-100`: `oklch(96.7% .001 286.375)`
- `--color-zinc-200`: `oklch(92% .004 286.32)`
- `--color-discord`: `#536bbd`
- `--color-rose-200`: `oklch(89.2% .058 10.001)`
- `--color-slate-200`: `oklch(92.9% .013 255.508)`
- `--color-sky-500`: `oklch(68.5% .169 237.323)`

## 3. Typography Rules

### Font Families
- **Primary**: `Inter`

### Custom Fonts Loaded
- **Inter** weight 100 900 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Inter | 96px | 900 | 1 | normal | Main headline (h1) |
| Sub-heading | Inter | 24px | 600 | 1.5 | -0.96px | Third-level heading (h3) |
| Button Large | Inter | 20px | 900 | 1.4 | normal | Button label (20px) |
| Label Heading | Inter | 16px | 700 | 1.5 | normal | Small heading (H4) |
| Body | Inter | 16px | 400 | 1.5 | normal | Standard reading text |
| Button | Inter | 14px | 700 | 1.43 | normal | Button label (14px) |
| Link | Inter | 14px | 400 | 1.43 | normal | Link (14px) — Decoration: none |
| Button Small | Inter | 12px | 500 | 1.33 | normal | Button label (12px) |

### Font Weight Scale

CSS custom properties define 7 explicit weight steps:
- `--font-weight-light`: `300` — Light
- `--font-weight-normal`: `400` — Regular
- `--font-weight-medium`: `500` — Medium
- `--font-weight-semibold`: `600` — SemiBold
- `--font-weight-bold`: `700` — Bold
- `--font-weight-extrabold`: `800` — ExtraBold
- `--font-weight-black`: `900` — Black

### Full Font Size Scale

Sizes detected in the design (descending): `96px`, `36px`, `30px`, `24px`, `20px`, `18px`, `16px`, `14px`, `13px`, `12px`, `11px`, `10.40px`, `10px`, `9.60px`, `9px`

> 9 size(s) detected outside the sampled hierarchy (36px, 30px, 18px, 13px, 11px, 10.4px, 10px, 9.6px, 9px). These appear on elements not in the sampled set — likely additional display sizes, marketing-section overrides, or third-party-widget styles.

## 4. Component Stylings

### Buttons

**Ghost**
- Background: `transparent`
- Text: `#171717` `{colors.primary-focus}`
- Padding: 4px 0px
- Radius: 0px
- Font: 20px weight 900
- Use: Subtle action, toolbar, nav button
- Focus: outline: `rgb(23, 23, 23) auto 3px`

**Ghost**
- Background: `transparent`
- Text: `#171717` `{colors.primary-focus}`
- Padding: 0px 8px 0px 4px
- Radius: 0px
- Font: 16px weight 400
- Use: Subtle action, toolbar, nav button
- Focus: outline: `rgb(23, 23, 23) auto 3px`

**Secondary**
- Background: `#737373` `{colors.primary}`
- Text: `#171717` `{colors.primary-focus}`
- Padding: 6px 8px
- Radius: 6px
- Border: 1px solid rgb(229, 229, 229)
- Font: 12px weight 500
- Use: Secondary action
- Focus: outline: `rgb(23, 23, 23) auto 3px`

**Outline**
- Background: `transparent`
- Text: `#171717` `{colors.primary-focus}`
- Padding: 6px 8px
- Radius: 6px
- Border: 1px solid rgb(229, 229, 229)
- Font: 12px weight 500
- Use: Secondary action with border
- Focus: outline: `rgb(23, 23, 23) auto 3px`

### Inputs & Forms

**Text Input**
- Background: `transparent`
- Text: `#171717` `{colors.primary-focus}`
- Padding: 4px 20px 16px
- Radius: 0px
- Border: 0px solid rgb(229, 229, 229)
- Font: 14px weight 400
- Use: Text fields, search inputs
- Focus: outline: `rgb(16, 16, 16) none 1px`


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative


*State transitions extracted via Playwright simulation — exact values in the YAML matrix below.*

```yaml
component-behaviors:
  button:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(23, 23, 23)"
    focus:
      bg: "transparent"
      fg: "inherit"
  input:
    default:
      bg: "rgb(229, 229, 229)"
      fg: "rgb(0, 0, 0)"
    focus:
      bg: "transparent"
      fg: "inherit"
  link:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(23, 23, 23)"
```

**Agent usage**: Validate generated components against this matrix. If your output's `:hover` state changes properties not listed here, you are off-brand.


## 4c. Component Vocabulary (Closed System)

*This brand uses ONLY the following component vocabulary. Introducing new variants without justification breaks the system's tonal coherence.*

### Buttons
- **3 shape(s)** in this system: `Ghost`, `Secondary`, `Outline`
- **DO NOT introduce new buttons variants** without justification

### Inputs & Forms
- **1 shape(s)** in this system: `Text Input`
- **DO NOT introduce new inputs & forms variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1200px

### Spacing System
Generous spacing — editorial breathing room

| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 4px |
| sm | 8px |
| md | 16px |
| base | 20px |
| lg | 27px |
| xl | 53px |
| 2xl | 64px |
| 3xl | 72px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `0px` |
| Inputs & Forms | `0px` |
| Page Body | `0px` |
| Primary Input | `0px` |

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

**Full Radius Spectrum**: 0px, 4px, 6px, 7px, 8px, 12px, 16px, 32px (from `allBorderRadii` scan)


## 5b. Spacing Rhythm Names

**Measured section padding**: bands use ~64px internal vertical padding (up to 64px) — **generous**. (Distinct from the gap *between* sections above.) Reproduce this generous vertical breathing room; cramped spacing is the #1 tell of a cheap clone.

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

| Name | Value | Use case |
|------|-------|----------|
| **hero** | `72px` | Top/bottom of full-bleed hero sections |
| **section** | `53px` | Between major bands (color change, content shift) |
| **subsection** | `27px` | Within a section, between content groups |
| **card** | `16px` | 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.).

## 5c. Widget & Structure Library

Structural patterns extracted from the page DOM — these are the **blueprints** an agent should follow to reproduce the page architecture (not just CSS values).

**3/8 structural patterns detected.**

### Hero Pattern

- **Composition:** left-aligned — 
- **Viewport coverage:** 104px tall (not full-viewport)
- **Heading:** "TanStack" — 96px left-aligned
- **CTAs:** none detected in hero (unusual — agent should verify)
- **Clone instruction:** Reproduce the **left-aligned** layout. Use the heading font-size token at the documented size. Pair the centered text with the hero’s decorative visual (gradient / SVG / hero image — see §9b), not bare text.

### Card Grid Pattern

- **Card count:** 3 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1024×860px (aspect 1.19:1)
- **Gap:** 96px between cards
- **Content:** ✓ image
- **Image position:** top
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~1.19:1 aspect ratio. Each card has an image at the top.

### Footer Pattern

- **Columns:** 1
- **Links:** 10 total
- **Height:** 194px
- **Includes:** ✗ no newsletter | ✓ social icons |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~10 links per column, social media links, and a copyright line.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgba(0, 0, 0, 0.05) 0px 1px 3px 0px`,<br>`rgba(0, 0, 0, 0.03) 0px 1px 2px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(15, 23, 42, 0.08) 0px 4px 12px 0px` | Cards, elevated surfaces |
| Layered (Level 3) | <br>`rgba(255, 107, 43, 0.08) 0px 1px 2px 0px` | Cards, elevated surfaces |
| Layered (Level 4) | <br>`rgba(246, 130, 31, 0.08) 0px 1px 2px 0px` | Cards, elevated surfaces |

**Shadow Philosophy**: Multi-layered shadow system creating natural, atmospheric depth. Each shadow level combines multiple layers for realistic elevation.

## 7. Motion & Interaction

### Easing System

| CSS Variable | Curve | Semantic Name |
|--------------|-------|---------------|
| `--default-transition-timing-function` | `cubic-bezier(.4, 0, .2, 1)` | Ease Out — Decelerating |
| `--ease-out` | `cubic-bezier(0, 0, .2, 1)` | Ease Out — Decelerating |
| `--ease-in-out` | `cubic-bezier(.4, 0, .2, 1)` | Ease Out — Decelerating |

### Duration Scale

| CSS Variable | Value | Tier |
|--------------|-------|------|
| `--default-transition-duration` | `.15s` | Fast |

### Copy-Paste Transition Snippets

**All Props**
```css
transition: 0.3s cubic-bezier(0.4, 0, 0.2, 1);
```

**Opacity**
```css
transition: opacity 1s cubic-bezier(0.4, 0, 0.2, 1);
```

**Transform**
```css
transition: transform 0.15s cubic-bezier(0.4, 0, 0.2, 1), translate 0.15s cubic-bezier(0.4, 0, 0.2, 1), scale 0.15s cubic-bezier(...;
```

**Color / Background**
```css
transition: color 0.15s cubic-bezier(0.4, 0, 0.2, 1), background-color 0.15s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.15s cub...;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `fadeIn` | Fade + Move | opacity, filter, transform | Element entrance |
| `pulseScale` | Scale | transform | Attention / status |
| `ship-peek` | Scale | transform | UI transition |
| `ship-pointer-events` | Custom | pointer-events | UI transition |
| `open-source-underline-color` | Color Pulse | color | UI transition |
| `open-source-underline-draw` | Custom | stroke-dashoffset | UI transition |
| `open-source-underline-drift` | Slide | transform | UI transition |
| `dropdown-in` | Fade + Move | opacity, transform | UI transition |
| `dropdown-out` | Fade + Move | opacity, transform | UI transition |
| `cart-panel-in` | Fade + Move | opacity, transform | UI transition |
| `cart-panel-out` | Fade + Move | opacity, transform | UI transition |
| `cart-overlay-in` | Fade | opacity | UI transition |
| `cart-overlay-out` | Fade | opacity | UI transition |
| `spin` | Rotate / Spin | transform | Loading indicator |
| `ping` | Fade + Move | opacity, transform | Attention / status |
| `pulse` | Fade | opacity | Attention / status |
| `bounce` | Slide | animation-timing-function, transform | Playful feedback |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 17 unique animations (17 total including variants)

> This design moves with deliberate & calm timing using custom cubic-bezier curves, creating a UI that feels calm and controlled.

## 8. Do's and Don'ts

### Do
- Use Pure White (`#fdfdfd`) as the page background — it's intentionally not pure white
- Use Near-Black (`#171717`) for text — not pure black, it's warmer and more readable
- Use Inter as the primary typeface — it defines the brand personality
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use Slate Grey (`#737373`) as the primary accent — it's the brand's signature interactive color
- Use 6px border-radius on buttons — the standard corner rounding for interactive elements
- Respect the 4px–53px spacing range — the design uses a wide scale for visual breathing room
- Each card includes a top image — imagery is part of the card identity, not optional

### Don't
- Don't use pure white (`#ffffff`) as a page background — the warm tone is part of the brand identity
- Don't use pure black (`#000000`) for text — the near-black adds warmth
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't invent new shadow values — use only the extracted shadow levels
- Don't introduce additional saturated accent colors — the palette is intentionally controlled
- Don't over-build the footer — this design keeps it minimal (1 cols, 10 links)


## 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(253, 253, 253)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(253, 253, 253)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(115, 115, 115)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(115, 115, 115)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 430px | Single column, compact spacing |
| Mobile | 480px | Single column, compact spacing |
| Mobile Large | 750px | Expanded mobile layout |
| Large Desktop | 1535px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `96px` | `48px` |
| heading | line-height | `96px` | `48px` |
| button | padding | `4px 0px` | `4px 8px` |

### Collapsing Strategy
- Headlines: 96px → 48px on mobile
- 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: 4px 0px padding
- Navigation: adequate spacing between items
- Interactive elements: minimum 44px touch target recommended

### Collapsing Narrative

How the structural patterns adapt from desktop to mobile (extracted from both viewport extractions):

- **Hero collapses left-aligned → centered** — composition shifts (verify on actual mobile render).


## 7c. Visual Effects & Dynamic Behavior

*The live/dynamic layer beyond static CSS — reproduce these, not flat substitutes. This is often what separates a faithful clone from a wireframe.*

- **Clip-path shapes** — 8 non-rectangular cut(s).

> **Motion fingerprint**: non-rectangular shapes (9)

## 9b. Visual Tone & Photography

**Tone:** Mixed photography + illustration

A balanced mix of photographic content and vector graphics. Photos likely carry product/lifestyle context while SVG handles icons, logos, and decorative accents.

**Canonical Brand Image (OG):**
- https://tanstack.com/assets/og-C0HGjoLl.png
  *This is the image shown when the site is shared on social media — represents the brand visual essence.*

**Hero Image (above-fold dominant visual):**
- Aspect: 1:1 (square / portrait)
- Rendered size: 400×400px
- Alt text: "TanStack Logo"
- *Use this aspect ratio + composition for your clone's hero — mimicking the proportion preserves the visual hierarchy.*

**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 22 (73%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 4 (13%)
- Ultra-wide (>2.3): 4 (13%)

**Media Format Mix:**
- PNG: 16 (logos, transparent UI elements, mockups)
- SVG: 4 (icons, illustrations, decorative geometry)

**Average rendered image size:** 307×203px
**Above-fold image count:** 3 / 30

**Decorative Patterns Detected:**
- 6 multi-stop linear gradients (mesh-like, 3+ color stops) — the brand leans on rich color transitions for visual depth
- 1 large decorative SVG shape (≥200×200px, non-icon) — likely blob/illustration accents
- **Glassmorphism** detected (`backdrop-filter: blur`) — layered transparent surfaces with blur, modern OS-like aesthetic

**Clone instruction for decorative work:** This is a gradient-rich design — invest in multi-stop CSS gradients (3+ color stops), not solid backgrounds.

**Imagery Guidance for clones:**
- Mix photography and illustration intentionally: photos for product/context, vectors for icons + decorative accents.
- Respect the format split — replacing JPGs with illustrations (or vice versa) will shift the brand tone.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Pure White (`#fdfdfd`)
- Primary text: Near-Black (`#171717`)
- Accent: Slate Grey (`#737373`)
- Border: Whitesmoke (`#e5e5e5`)
- Font: Inter
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#fdfdfd). Headline at 96px Inter weight 900, line-height 1, color #171717."
- "Create the primary CTA button: `#737373` background, `#171717` text, 9999px border-radius, 4px 0px padding, 900 weight, Inter font."
- "Build navigation: sticky on `#fdfdfd`. Inter 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#fdfdfd`) — every component is composited against this exact base.
2. **Typography**: All type in Inter, weight range 300–900. Never exceed 900 — heavier weights break the brand's tonal restraint.
3. **Accent**: Slate Grey (`#737373`) is the sole interactive color. On hover → #784b30 (`#784b30`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,0.2,1)`. Timing: 150ms for micro-interactions, 150ms for layout changes. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (4px–53px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
7. **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: #fdfdfd;
  --ca-surface-1: #ffffff;
  --ca-surface-2: #f5f5f5;
  --ca-primary-focus: #171717;
  --ca-primary: #737373;
  --ca-on-primary: #111111;
  --ca-primary-hover: #784b30;
  --ca-hairline: #e5e5e5;
}

/* Typography */
:root {
  --ca-font-primary: "Inter", system-ui, sans-serif;
  --ca-text-display: 96px;
  --ca-text-body: 16px;
  --ca-text-small: 14px;
  --ca-text-button: 20px;
}

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

/* Motion */
:root {
  --ca-ease-out: cubic-bezier(0, 0, .2, 1);
  --ca-ease-in-out: cubic-bezier(.4, 0, .2, 1);
}
```


## 13. Page Structure Skeleton

*The actual layout the source site uses. Reproduce these sections in order to match the site structure.*

```yaml
page-skeleton:
  - section: navigation
    tag: div
    classes: ["min-h-[calc(100dvh-var(--navbar-height))]", "flex", "flex-col", "min-w-0"]
    height: 10117px
    width: full-bleed
    layout: flex-row justify=normal
    children: 2
    vertical-padding: ~27px
    padding: "53px 0px 0px"
  - section: unknown
    tag: div
    classes: ["pointer-events-none", "fixed", "top-0", "left-0"]
    height: 320px
    width: full-bleed
    layout: block
    children: 2
  - section: feature-section
    tag: section
    classes: ["py-16"]
    height: 988px
    width: 992px
    layout: block
    children: 3
    vertical-padding: ~64px (generous)
    padding: "64px 0px"
```

**Agent rule**: rebuild sections in this order (sorted by vertical position). Match the layout primitive (grid N-col / flex direction / block).


## 14. Copy Library (Real Content from Source)

*Actual text content extracted from the live page. Use these strings verbatim when reproducing the site — they carry the brand voice.*

```yaml
copy:
  section-headings:
    - "The open-source application stack for the web."
    - "Built with TanStack"
  sub-headings:
    - "What would you like to build?"
    - "Browse the stack"
    - "Why TanStack?"
    - "TanStack.com"
    - "TanStack on Discord"
    - "The Best JavaScript Newsletter"
  ctas:
    - "Search... K"
    - "Auto"
    - "Log In"
    - "Start RC"
    - "More Libraries"
  navigation:
    - "More Libraries"
    - "Builder ALPHA"
    - "Blog"
    - "Maintainers"
    - "Partners"
    - "Showcase"
    - "Learn NEW"
    - "Stats"
    - "YouTube"
    - "Discord"
```

**Agent rule**: reuse these exact strings when generating UI. Do NOT translate or rephrase — brand voice is preserved through the original wording.


## 15. Asset Inventory (Image Roles & Ratios)

*Image inventory classified by role and aspect ratio. When reproducing the site, allocate this number of assets per role.*

```yaml
assets:
  logo:
    count: 8
    avg-ratio: 3.45
    common-aspect: "~16:6 banner"
  product:
    count: 1
    avg-ratio: 1.00
    common-aspect: "~1:1 square"
    sample-alts:
      - "TanStack Logo"
  thumbnail:
    count: 5
    avg-ratio: 0.98
    common-aspect: "~1:1 square"
```

**Agent rule**: when generating placeholder images, match these counts and aspect ratios. Use neutral placeholder backgrounds for `product` (e.g. `#f5f5f5`), full-color photography hints for `hero` and `editorial`.


## 16. Component HTML Templates

*Suggested HTML markup for reproducing the key components — based on what was detected in the source DOM.*

### Button (primary action)
```html
<button class="btn btn-primary">
  Action
</button>
```
_Source pattern detected: padding `0px 8px 0px 4px` · radius `0px` · weight `400`_

**Agent rule**: use these markup skeletons as the structural baseline. Apply tokens from §2-3 for visual styling.


## 17. Content Architecture & Resources (Links by Purpose)

*The page's links classified by purpose — the information architecture to reproduce. Categories, featured images, devices and projects are extracted from the rendered DOM, not guessed.*

**By purpose:** **nav** 29 · **auth** 1 · **docs** 1 · **blog** 1 · **project** 2 · **social** 3 · **other** 23

**Primary actions (conversion path):**
- Account access — "Log In" (login/signup) → `https://tanstack.com/login`

**Projects / case studies detected** (clustered by URL + featured image):

*Stack* — medium confidence, 5 items:

| Title | Featured image | Link |
|---|---|---|
| Framework 1 Start 2 Router Browse framework | — | https://tanstack.com/stack/framework |
| Data & State Management 1 Query 2 DB 3 Store | — | https://tanstack.com/stack/state |
| UI & UX 1 Table 2 Form 3 Hotkeys Browse ui & | — | https://tanstack.com/stack/ui |
| Performance 1 Virtual 2 Pacer Browse perform | — | https://tanstack.com/stack/performance |
| Tooling 1 Devtools 2 Config 3 CLI 4 Intent B | — | https://tanstack.com/stack/tooling |

**Signals:** 44/60 links carry a featured image · device mockups detected: laptop ×1 · dominant link roles: content-card (30), navigation (29), inline-link (1).


---
## Extraction Completeness: 75/100 (B)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 18 | 25 | 13 named colors |
| Typography | 20 | 20 | 8 roles defined |
| Components | 8 | 20 | 2 specs extracted |
| Motion & Interaction | 15 | 15 | Keyframes, easing vars |
| CSS Custom Properties | 10 | 10 | 337 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:*

- **Licensed web fonts (Inter)** — detected but not downloaded. Substitute with your licensed copy or a close fallback (see Typography section for metrics).
- **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.
- **4 parasitic shadow(s) detected** — colored box-shadows (not near-black) found in allShadows. These likely originate from browser extensions or third-party injected widgets (e.g. Grammarly, chat overlays), not from the site's own design system. Discard them when building.

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 337 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 8 typography roles inferred |
| §4 Components | Low | 2 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 14 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 4 breakpoints detected |
| §9b Photography | High | 30 images, hero present |

## 11.1 CSS Implementation Guide (CSS Interception Engine v2.15+)

*Ready-to-use CSS from Prism's CSS Interception Engine — intercepted directly from the site's CSS files (bypasses CORS). Copy-paste into your `<style>` block.*

### Font Loading

1 font file(s) captured (71KB total). When running `prism add`, fonts are saved to `extractions/tanstack.com/fonts/` and embedded as base64 in the output HTML.

**@font-face declarations to use:**
```css
@font-face {
  font-family: 'Inter';
  /* src: url('/fonts/Inter.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: normal;
  font-display: swap;
}
```

### Keyframe Animations (Intercepted from CSS)

**17 @keyframes found** — these are the real animation definitions:

```
@keyframes fadeIn { ... }
@keyframes pulseScale { ... }
@keyframes ship-peek { ... }
@keyframes ship-pointer-events { ... }
@keyframes open-source-underline-color { ... }
@keyframes open-source-underline-draw { ... }
@keyframes open-source-underline-drift { ... }
@keyframes dropdown-in { ... }
@keyframes dropdown-out { ... }
@keyframes cart-panel-in { ... }
@keyframes cart-panel-out { ... }
@keyframes cart-overlay-in { ... }
@keyframes cart-overlay-out { ... }
@keyframes spin { ... }
@keyframes ping { ... }
@keyframes pulse { ... }
@keyframes bounce { ... }
```

<details><summary>Full keyframes CSS (17 animations)</summary>

```css
@keyframes fadeIn{0%{opacity:0;filter:blur(4px);transform:scale(.97)}
@keyframes pulseScale{0%{transform:scale(1)}50%{transform:scale(var(--scale-factor,1.1))}
@keyframes ship-peek{0%,to{transform:translate(-50%)translateY(0)scale(1)scaleX(-1)}12%{transform:translateX(calc(-50% - var(--ship-x))) translateY(calc(-1 * var(--ship-y))) scale(1.15) scaleX(-1)}32%{transform:translateX(calc(-50% - var(--ship-x))) translateY(calc(-1 * var(--ship-y))) scale(1.15) scaleX(-1)}35%{transform:translate(-50%)translateY(0)scale(1)scaleX(-1)}}
@keyframes ship-pointer-events{0%,11%,33%,to{pointer-events:none}12%,32%{pointer-events:auto}}
@keyframes open-source-underline-color{0%,22%,to{color:#eab308}25%,47%{color:#14b8a6}50%,72%{color:#3b82f6}75%,97%{color:#f43f5e}}
@keyframes open-source-underline-draw{0%{stroke-dashoffset:1px}
@keyframes open-source-underline-drift{0%,to{transform:translate(0)}30%{transform:translate(2.2px,-1.7px)}55%{transform:translate(-2.5px,1.45px)}80%{transform:translate(1.2px,-.8px)}}
@keyframes dropdown-in{0%{opacity:0;transform:scale(.95)translateY(-4px)}
@keyframes dropdown-out{0%{opacity:1;transform:scale(1)translateY(0)}
@keyframes cart-panel-in{0%{opacity:0;transform:translate(1rem)}
@keyframes cart-panel-out{0%{opacity:1;transform:translate(0)}
@keyframes cart-overlay-in{0%{opacity:0}
@keyframes cart-overlay-out{0%{opacity:1}
@keyframes spin{to{transform:rotate(360deg)}}
@keyframes ping{75%,to{opacity:0;transform:scale(2)}}
@keyframes pulse{50%{opacity:.5}}
@keyframes bounce{0%,to{animation-timing-function:cubic-bezier(.8,0,1,1);transform:translateY(-25%)}50%{animation-timing-function:cubic-bezier(0,0,.2,1);transform:none}}
```
</details>

### Hover State CSS (Intercepted)

**1 hover rule lines** captured from CSS files. Key interactive transitions from real CSS (not inferred):

```css
.anchor-heading:hover>:after{opacity:.5}

:hover>.anchor-heading-link{opacity:.5}
```

> **Note**: All values above are extracted from the live site's CSS files. The font files are saved locally by Prism and embedded in the output HTML. Use them as-is for maximum fidelity.

## 11.2 Measured Reality (CDP Engine)

Captured directly from Chrome's engine across **all 1987 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**4 breakpoints** read from the live `@media` rules (not guessed):
`430px` · `480px` · `750px` · `1535px`

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×841 · `14px`×447 · `12px`×408 · `10px`×60 · `11px`×49 · `30px`×28 · `24px`×26 · `9px`×26

**Radius scale** (× = paint count): `8px`×105 · `6px`×95 · `4px`×29 · `12px`×24 · `16px`×1 · `32px`×1 · `100%`×1

**Weights** (× = paint count): `400`×1026 · `500`×450 · `600`×185 · `700`×170 · `900`×131 · `300`×24

**Layout gaps** (× = paint count): `8px`×175 · `4px`×154 · `6px`×25 · `10px`×15 · `8px 16px`×13 · `12px`×11 · `16px`×8 · `24px`×6

**Elevation (real shadows)**:
```css
rgba(0, 0, 0, 0.05) 0px 4px 6px -1px, rgba(0, 0, 0, 0.03) 0px 2px 4px -1px
rgba(0, 0, 0, 0.05) 0px 1px 3px 0px, rgba(0, 0, 0, 0.03) 0px 1px 2px 0px
rgba(0, 0, 0, 0.03) 0px 1px 2px 0px
rgba(0, 0, 0, 0.05) 0px 10px 15px -3px, rgba(0, 0, 0, 0.03) 0px 4px 6px -2px
```

### Provenance — measured styles on key elements
Read from the live CSSOM (includes runtime-injected CSS). This is *what actually styles the page*, by element:

```css
body { color:var(--color-gray-900) }
body { background-color:#fdfdfd }
h1 { font-size:var(--text-5xl) }
h1 { font-weight:var(--font-weight-black) }
@media (width >= 48rem) h1 { font-size:var(--text-6xl) }
@media (width >= 64rem) h1 { font-size:var(--text-8xl) }
h2 { font-size:var(--text-2xl) }
h2 { font-weight:var(--font-weight-bold) }
@media (width >= 48rem) h2 { font-size:var(--text-4xl) }
a { gap:calc(var(--spacing) * 1.5) }
input { border-radius:.25rem }
input { background-color:var(--color-gray-200) }
```

> Selectors normalised to their semantic element — source class names are often build-hashed (`.bgDIHX`) and not reusable. The declarations + CSS vars are the transferable part.

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://tanstack.com | 2026-06-11T06:19:01.125Z*
*Values extracted via getComputedStyle() (rendered) + CSS custom properties (tokens, marked `(token)`). Token-only values may not be painted — verify against the live site before shipping.*