--- 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) |
`rgba(0, 0, 0, 0.05) 0px 1px 3px 0px`,
`rgba(0, 0, 0, 0.03) 0px 1px 2px 0px` | Cards, elevated surfaces | | Layered (Level 2) |
`rgba(15, 23, 42, 0.08) 0px 4px 12px 0px` | Cards, elevated surfaces | | Layered (Level 3) |
`rgba(255, 107, 43, 0.08) 0px 1px 2px 0px` | Cards, elevated surfaces | | Layered (Level 4) |
`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 ``` _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 `