hono.dev

DESIGN.md

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

---
version: alpha
name: hono.dev
description: "Light product system built on #ffffff with #f6f6f7 as the primary CTA accent. Type anchored in -apple-system at 56px / weight 700. Extracted automatically from https://hono.dev/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
  hono.dev is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses rgb(246, 246, 247) as a near-neutral accent (low saturation).
  Moderately rounded CTAs (8px) — modern SaaS standard, neither sharp nor pill alongside -apple-system as the primary typeface.
  A restrained elevation system (2 distinct shadows) — shadows reserved for the few elements that must lift off the page.
  Interactions are smoothed by transitions across many elements, with little or no keyframe animation.

colors:
  background: "#ffffff"
  surface-1: "#f6f6f7"
  surface-2: "#ebebef"
  ink: "#1f2328"
  ink-subtle: "#808080"
  primary: "#f6f6f7"
  on-primary: "#111111"
  primary-hover: "#e4e4e9"
  hairline: "#454545"
  primary-focus: "#101010"
  semantic-error: "rgba(244, 63, 94, .14)"
  semantic-success: "#18794e"
  semantic-warning: "#915930"
  semantic-info: "#bff8d7"

typography:
  display-xl:
    fontFamily: "Inter, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
    letterSpacing: 0
  display-md:
    fontFamily: "apple color emoji, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 16px
    fontWeight: 700
    lineHeight: 1.5
    letterSpacing: 0
  body:
    fontFamily: "apple color emoji, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 12px
    fontWeight: 700
    lineHeight: 2
    letterSpacing: 0
  body-sm:
    fontFamily: "apple color emoji, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 14px
    fontWeight: 500
    lineHeight: 4.57
    letterSpacing: 0
  caption:
    fontFamily: "apple color emoji, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 24px
    fontWeight: 500
    lineHeight: 1.5
    letterSpacing: 0
  button:
    fontFamily: "apple color emoji, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 13.3333px
    fontWeight: 500
    lineHeight: 1.8
    letterSpacing: 0

rounded:
  none: 0px
  xs: 6px
  sm: 8px
  md: 12px
  lg: 20px
  xl: 32px
  pill: 9999px

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

components:
  button-light--invert:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.hairline}"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 0px 10px 0px 12px
  button-pill:
    backgroundColor: "#8e96aa"
    textColor: "{colors.ink}"
    typography: "{typography.button}"
    rounded: "{rounded.md}"
  button-pill-2:
    backgroundColor: "{colors.background}"
    textColor: "#e36002"
    typography: "{typography.body}"
    rounded: "{rounded.sm}"
    padding: 8px 16px
  card-standard-card:
    backgroundColor: "transparent"
    typography: "{typography.display-xl}"
    rounded: "{rounded.none}"
    padding: 24px

extracted_at: "2026-06-11T06:10:08.253Z"
completeness: 66
scoreVersion: "v2"

---

# Design System — hono.dev
> Extracted automatically by Prism from https://hono.dev
> 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**: moderate  |  **Motion**: subtle  |  **Weight**: heavy  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (-apple-system) | "Web application framework" |
| Color assertion | dual-accent | #f6f6f7 |
| Whitespace | moderate | section rhythm 48px |
| Interaction | subtle | 1 keyframes, 14 transitions |
| Radius language | 8px-rounded | from token scale |

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

> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `rgb(255, 255, 255)` is the page background. Every component composits against this.
> - **Accent**: `rgb(246, 246, 247)` 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.
>
> **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

hono.dev uses a pure-white canvas (`#ffffff`), letting typography, color and imagery carry the visual weight. 

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

Body text reads in Near-Black (`#1f2328`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Off-White** (`#f6f6f7`) provides interactive distinction without visual aggression. Elevation comes from a small, deliberate set of shadows (2 distinct), each a multi-layer stack — several blurred layers at varying offsets — used sparingly rather than across the whole UI. 


**Key Characteristics:**
- Background: Pure White (`#ffffff`)
- Primary typeface: Inter
- Primary text: Near-Black (`#1f2328`)
- Accent: Off-White (`#f6f6f7`)
- Shadow system: 2 distinct elevation levels
- Custom fonts loaded: Inter, Punctuation SC

## 2. Color Palette & Roles

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

### Text & Content
- **Near-Black** (`#1f2328`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Translucent Dark Gray (12%)** (`rgba(60, 60, 67, 0.12)`): Secondary text

### Accent & Interactive
- **Bright Orange** (`#e36002`): Interactive / accent
- **Translucent Cool Gray (14%)** (`rgba(142, 150, 170, 0.14)`): Interactive / accent
- **#ff9c24** (`#ff9c24`): Interactive / accent

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

- `#454545` — Charcoal
- `#959595` — Grey
- `#e3e3e5` — Whitesmoke *(token)*
- `#bff8d7` — #bff8d7 *(token)*
- `#1fd85d` — #1fd85d *(token)*
- `#915930` — #915930 *(token)*
- `#f9f9fc` — Off-White *(token)*
- `rgba(234, 179, 8, 0.14)` — Translucent Amber (14%) *(token)*
- `#e07700` — #e07700 *(token)*
- `#3772cf` — Royal Blue *(token)*
- `#18794e` — Teal *(token)*
- `#3a5ccc` — Royal Blue *(token)*
- `#f6f8fa` — Off-White *(token)*
- `rgba(255, 255, 245, 0.86)` — Translucent Cream (86%) *(token)*
- `rgba(159, 122, 234, 0.14)` — Translucent #9f7aea (14%) *(token)*
- `rgba(244, 63, 94, 0.14)` — Translucent Warm Rose (14%) *(token)*
- `#308b58` — Teal *(token)*
- `#d7d7d9` — Light Grey *(token)*
- `#7e4cc9` — Slate Blue *(token)*
- `#5468ff` — Brand Indigo *(token)*
- `#db2777` — Cherry *(token)*
- `#d5393e` — Vermillion *(token)*
- `#8e5cd9` — Amethyst *(token)*
- `rgba(235, 235, 245, 0.38)` — Translucent Light Gray (38%) *(token)*
- `#808080` — Slate Grey *(token)*
- `#946300` — #946300 *(token)*
- `#9f6a00` — #9f6a00 *(token)*
- `#3451b2` — #3451b2 *(token)*
- `#e4e4e9` — Whitesmoke *(token)*
- `#b8272c` — #b8272c *(token)*
- `#6f42c1` — Slate Blue *(token)*
- `#ff861d` — #ff861d *(token)*
- *…+27 more in `raw-css.json` (`desktop.allColors`).*

### Gradients & Decorative Fills

- `linear-gradient(-225deg,#d5dbe4,#f8f8f8)` — (--docsearch-key-gradient)

### CSS Custom Properties (Design Tokens)

**Font Family Token**
- `--vp-font-family-mono`: `ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace`

**Shadow Token**
- `--vp-shadow-5`: `0 18px 56px rgba(0, 0, 0, .16), 0 4px 12px rgba(0, 0, 0, .16)`
- `--vp-shadow-1`: `0 1px 2px rgba(0, 0, 0, .04), 0 1px 2px rgba(0, 0, 0, .06)`
- `--vp-shadow-3`: `0 12px 32px rgba(0, 0, 0, .1), 0 2px 6px rgba(0, 0, 0, .08)`
- `--vp-shadow-4`: `0 14px 44px rgba(0, 0, 0, .12), 0 3px 9px rgba(0, 0, 0, .12)`

**Spacing Token**
- `--docsearch-spacing`: `12px`

**Font Size Token**
- `--vp-code-font-size`: `.875em`
- `--twoslash-code-font-size`: `1em`
- `--vp-custom-block-font-size`: `14px`
- `--vp-custom-block-code-font-size`: `13px`

**Z-Index Token**
- `--vp-z-index-sidebar`: `25`
- `--vp-z-index-backdrop`: `50`
- `--vp-z-index-footer`: `10`
- `--vp-z-index-nav`: `30`

**Other tokens**
- `--vp-local-nav-bg-color`: `#ffffff`
- `--twoslash-tag-bg`: `#3772cf20`
- `--vp-c-text-3`: `#959595`
- `--vp-c-bg-soft-mute`: `#e3e3e5`
- `--vp-badge-info-bg`: `#bff8d7`
- `--vp-code-line-number-color`: `#959595`
- `--twoslash-docs-color`: `#1f2328`
- `--vp-custom-block-info-code-bg`: `rgba(142, 150, 170, .14)`

## 3. Typography Rules

### Font Families
- **Primary**: `-apple-system`
- **Secondary**: `Inter`
- **Font 3**: `Punctuation SC`

### Custom Fonts Loaded
- **Inter** weight 100 900 (normal)
- **Punctuation SC** weight 400 (normal)
- **Punctuation SC** weight 500 (normal)
- **Punctuation SC** weight 600 (normal)
- **Punctuation SC** weight 700 (normal)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Caption / Badge | apple color emoji | 24px | 500 | 1.5 | normal | small text (24px) |
| Display Hero | Inter | 16px | 400 | 1.5 | normal | Main headline (h1) |
| Sub-heading | apple color emoji | 16px | 700 | 1.5 | normal | Section titles (h2) |
| Card Title | apple color emoji | 16px | 400 | 1.5 | normal | Card headings |
| Link | apple color emoji | 14px | 500 | 4.57 | normal | Link (14px) — Decoration: none |
| Link | apple color emoji | 14px | 600 | 2.71 | normal | Link (14px) — Decoration: none |
| Button | apple color emoji | 13.3333px | 500 | 1.8 | normal | Button label (13.3333px) |
| Button | apple color emoji | 13.3333px | 400 | 1.8 | normal | Button label (13.3333px) |
| Link Small | apple color emoji | 12px | 700 | 2 | normal | Link (12px) — Decoration: none |

### Full Font Size Scale

Sizes detected in the design (descending): `56px`, `24px`, `20px`, `16px`, `14px`, `13.33px`, `13px`, `12px`

> 3 size(s) detected outside the sampled hierarchy (56px, 20px, 13px). 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

**Light / Invert**
- Background: `#f6f6f7` `{colors.primary}`
- Text: `#454545` `{colors.hairline}`
- Padding: 0px 10px 0px 12px
- Radius: 8px
- Border: 1px solid rgba(0, 0, 0, 0)
- Font: 13.3333px weight 500
- Use: Bright CTA on dark sections
- Hover: backgroundColor: `#ffffff`, color: `#1f2328`, outline: `rgb(31, 35, 40) none 3px`
- Focus: backgroundColor: `rgba(0, 0, 0, 0)`, color: `rgb(31, 35, 40)`, border: `1px solid rgba(227, 96, 2, 0.05)`

**Pill**
- Background: `rgba(142, 150, 170, 0.14)`
- Text: `#1f2328` `{colors.ink}`
- Padding: 0px
- Radius: 11px
- Border: 1px solid rgba(60, 60, 67, 0.29)
- Font: 13.3333px weight 400
- Use: Status pills, tags, chips
- Hover: backgroundColor: `#ffffff`, color: `#1f2328`, outline: `rgb(31, 35, 40) none 3px`
- Focus: backgroundColor: `rgba(0, 0, 0, 0)`, color: `rgb(31, 35, 40)`, border: `1px solid rgba(227, 96, 2, 0.05)`

**Pill**
- Background: `#ffffff` `{colors.background}`
- Text: `#e36002`
- Padding: 8px 16px
- Radius: 8px
- Shadow: `rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0px 2px 6px 0px`
- Font: 12px weight 700
- Use: Status pills, tags, chips
- Hover: backgroundColor: `#ffffff`, color: `#1f2328`, outline: `rgb(31, 35, 40) none 3px`
- Focus: backgroundColor: `rgba(0, 0, 0, 0)`, color: `rgb(31, 35, 40)`, border: `1px solid rgba(227, 96, 2, 0.05)`

### Cards & Containers

**Standard Card**
- Background: `transparent`
- Padding: 24px
- Radius: 0px
- Use: Content containers, listing items


## 4b. Component Behaviors (State Matrix)

### Interaction State Narrative

- **Button**:
  - **hover:** bg #f6f6f7 → #ffffff, text #454545 → #1f2328
  - **focus:** bg #f6f6f7 → transparent, text #454545 → #1f2328, border changes

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

```yaml
component-behaviors:
  button:
    default:
      bg: "rgb(246, 246, 247)"
      fg: "rgb(69, 69, 69)"
      border: "1px solid rgba(0, 0, 0, 0)"
    hover:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(31, 35, 40)"
    focus:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(31, 35, 40)"
      border: "1px solid rgba(227, 96, 2, 0.05)"
  link:
    default:
      bg: "rgb(255, 255, 255)"
      fg: "rgb(227, 96, 2)"
      shadow: "rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0p"
  card:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(31, 35, 40)"
  navLink:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(31, 35, 40)"
  badge:
    default:
      bg: "rgba(0, 0, 0, 0)"
      fg: "rgb(69, 69, 69)"
```

**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
- **2 shape(s)** in this system: `Light / Invert`, `Pill`
- **DO NOT introduce new buttons variants** without justification

### Cards & Containers
- **1 shape(s)** in this system: `Standard Card`
- **DO NOT introduce new cards & containers variants** without justification

## 5. Layout Principles

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

### Grid
Single column, centered content

### Max Width
1440px

### Spacing System
Compact spacing — information density prioritized

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

### Border Radius Scale
| Name | Value | Use |
|------|-------|-----|
| None | 0px | No rounding |
| Xs | 6px | Tiny corners (badges, micro elements) |
| Sm | 8px | Buttons, inputs, small elements |
| Md | 12px | 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 |
|-----------|---------------|
| Buttons | `8px` |
| Cards & Containers | `0px` |
| Page Body | `0px` |
| Navigation | `0px` |

**Shape Personality**: Moderate Rounding — Medium corners (4–12px). Modern SaaS standard, neither sharp nor pill.

**Full Radius Spectrum**: 0px, 4px, 6px, 8px, 11px, 12px, 20px (from `allBorderRadii` scan)


## 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** | `10px` | Form fields, tight clusters, badge padding |
| **micro** | `8px` | 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).

**4/8 structural patterns detected.**

### Hero Pattern

- **Composition:** left-aligned — 
- **Viewport coverage:** 348px tall (not full-viewport)
- **Heading:** "HonoWeb application framework" — 16px left-aligned
- **Subheading:** "Fast, lightweight, built on Web Standards. Support for any JavaScript runtime."
- **CTAs:** 2 (primary: "Get Started")
- **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.

### Navigation Pattern

- **Position:** static (scrolls with page)
- **Layout:** unknown — Layout not classified
- **Height:** 64px
- **Logo:** ✗ absent
- **Nav links:** 3 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a static unknown navigation. Link-only — no button styling needed.

### Card Grid Pattern

- **Card count:** 4 cards detected
- **Columns (desktop):** 5-up grid
- **Card dimensions:** 292×262px (aspect 1.11:1)
- **Gap:** 0px between cards
- **Content:** ✗ no image
- **Clone instruction:** Build a 5-column grid (desktop) with cards at ~1.11:1 aspect ratio. Text/icon-only cards (no photography).

### Footer Pattern

- **Columns:** 1
- **Links:** 0 total
- **Height:** 113px
- **Includes:** ✗ no newsletter | ✗ no social |  ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~0 links per column, 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.1) 0px 12px 32px 0px`,<br>`rgba(0, 0, 0, 0.08) 0px 2px 6px 0px` | Cards, elevated surfaces |
| Layered (Level 2) | <br>`rgba(0, 0, 0, 0.04) 0px 1px 2px 0px`,<br>`rgba(0, 0, 0, 0.06) 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

### Duration Scale

| Value | Tier | Typical Use |
|-------|------|-------------|
| `250ms` | Normal | Panel open/close, navigation |
| `500ms` | Slow | Hero animations, page transitions |

### Copy-Paste Transition Snippets

**Background**
```css
transition: background-color 0.5s;
```

**Background**
```css
transition: background-color 0.25s;
```

**Opacity**
```css
transition: opacity 0.25s;
```

**Border**
```css
transition: border-color 0.25s;
```

### Keyframe Animation Catalog

| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `fade-in` | Fade | opacity | Element entrance |

### Motion Fingerprint

- **Speed Character**: Deliberate & Calm (median duration: `500ms`)
- **Dominant Easing**: standard CSS easings
- **Animation Library**: 1 unique animation (1 total including variants)

> This design moves with deliberate & calm timing using standard CSS easings, creating a UI that feels calm and controlled.

## 8. Do's and Don'ts

### Do
- Use Near-Black (`#1f2328`) for text — not pure black, it's warmer and more readable
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use Off-White (`#f6f6f7`) as the primary accent — it's the brand's signature interactive color
- Use 8px border-radius on buttons — the standard corner rounding for interactive elements
- Apply 24px padding inside cards — matches the design system's content breathing room
- Maintain nav height at 64px — consistent vertical space for the navigation bar
- Transition button background to Pure White (`#ffffff`) on hover — this is the extracted interactive state
- Include exactly 2 CTAs in the hero (primary + secondary) — this design pattern is multi-action, not single-purpose
- Use a 5-column grid on desktop — density matters for this content type

### Don't
- Don't use pure black (`#000000`) for text — the near-black adds warmth
- 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 collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence
- Don't use opacity or brightness filter for button hover — the design uses an explicit background color change
- Don't make the nav sticky — this design lets it scroll away to maximize content focus
- Don't put a CTA button in the nav — this design uses links only at the top
- Don't over-build the footer — this design keeps it minimal (1 cols, 0 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(255, 255, 255)` as the base canvas"
    why: "Every component is designed to composit against this exact tone"
    test: "document.body.style.backgroundColor === 'rgb(255, 255, 255)'"
  - id: brand-accent-001
    type: do
    rule: "Reserve `rgb(246, 246, 247)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(246, 246, 247)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 375px | Single column, compact spacing |
| Mobile Large | 639px | Expanded mobile layout |
| Mobile Large | 767px | Expanded mobile layout |
| Tablet | 960px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Large Desktop | 1440px | Maximum content width |

### Token Diff — Desktop vs Mobile

| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| nav | display | `flex` | `none` |
| nav | height | `64px` | `auto` |
| button | padding | `0px 10px 0px 12px` | `0px` |
| button | width | `145.891px` | `40px` |
| card | width | `274px` | `340px` |

### Collapsing Strategy
- Navigation: flex → none on mobile
- Cards: multi-column → stacked vertical on mobile
- Footer: multi-column → stacked single column on mobile

### Touch Targets
- Buttons: 0px 10px 0px 12px 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).
- **Card grid: 5-up → 1-up** — cards stack as viewport narrows, becoming a vertical list on mobile.


## 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** — 2 non-rectangular cut(s).

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

## 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://hono.dev/images/hono-title.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.76:1 (landscape (16:9-ish))
- Rendered size: 564×320px
- Alt text: "An example of code for Hono. import { Hono } from 'hono' const app = new Hono() app.get('/', (c) => c.text('Hello Hono!'"
- *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): 1 (100%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 0 (0%)

**Media Format Mix:**
- WebP: 1 (optimized photo/illustration hybrid)

**Average rendered image size:** 564×320px
**Above-fold image count:** 1 / 1

**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 (`#ffffff`)
- Primary text: Near-Black (`#1f2328`)
- Accent: Off-White (`#f6f6f7`)
- Border: Charcoal (`#454545`)
- Font: apple color emoji
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 16px apple color emoji weight 400, line-height 1.5, color #1f2328."
- "Create the primary CTA button: `#f6f6f7` background, `#454545` text, 8px border-radius, 0px 10px 0px 12px padding, 500 weight, apple color emoji font."
- "Design a card on `transparent` background. Border: none. Radius: 0px. Shadow: none. Padding: 24px."
- "Build navigation: static on `#ffffff`. apple color emoji 16px weight 400 for links."

### Iteration Guide
1. **Canvas**: Set the light canvas to Pure White (`#ffffff`) — every component is composited against this exact base.
2. **Typography**: All type in apple color emoji, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: Off-White (`#f6f6f7`) is the sole interactive color. On hover → Bright Orange (`#e36002`). Use CSS transitions, not opacity/brightness filters.
4. **Shape**: CTAs at `8px`, cards at `0px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
5. **Spacing**: Use the `--ca-space-*` token scale (8px–32px). All padding, margin, and gap values are multiples from this scale — no magic numbers.
6. **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: #ffffff;
  --ca-primary: #f6f6f7;
  --ca-surface-2: #ebebef;
  --ca-ink: #1f2328;
  --ca-ink-subtle: #808080;
  --ca-on-primary: #111111;
  --ca-primary-hover: #e4e4e9;
  --ca-hairline: #454545;
  --ca-primary-focus: #101010;
  --ca-semantic-error: #f43f5e;
  --ca-semantic-success: #18794e;
  --ca-semantic-warning: #915930;
  --ca-semantic-info: #bff8d7;
}

/* Typography */
:root {
  --ca-font-primary: "apple color emoji", system-ui, sans-serif;
  --ca-text-display: 16px;
  --ca-text-body: 12px;
  --ca-text-small: 14px;
  --ca-text-caption: 24px;
  --ca-text-button: 13.3333px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 8px;
  --ca-space-sm: 10px;
  --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: 6px;
  --ca-radius-sm: 8px;
  --ca-radius-md: 12px;
  --ca-radius-lg: 20px;
  --ca-radius-xl: 32px;
  --ca-radius-full: 9999px;
}
```


## 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: content-section
    tag: div
    height: 1043px
    width: full-bleed
    layout: block
    children: 1
  - section: content-section
    tag: div
    classes: ["Layout"]
    height: 1043px
    width: full-bleed
    layout: flex-column justify=normal
    children: 5
    vertical-padding: ~48px
  - section: unknown
    tag: div
    classes: ["image-container"]
    height: 348px
    width: 560px
    layout: flex-row justify=center
    children: 2
  - section: unknown
    tag: div
    classes: ["container"]
    height: 348px
    width: 1152px
    layout: flex-row justify=normal
    children: 2
  - section: content-section
    tag: div
    classes: ["container"]
    height: 262px
    width: 1152px
    layout: block
    children: 1
  - section: footer
    tag: footer
    classes: ["VPFooter"]
    height: 113px
    width: full-bleed
    layout: block
    children: 1
    bg: "rgb(255, 255, 255)"
    vertical-padding: ~32px
    padding: "32px"
```

**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:
    - "Ultrafast & Lightweight"
  ctas:
    - "Search K"
  navigation:
    - "Hono"
    - "Docs"
    - "Examples"
    - "Discussions"
```

**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:
  icon:
    count: 1
    avg-ratio: 0.79
    common-aspect: "~9:16 portrait"
```

**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">
  Search
K
</button>
```
_Source pattern detected: padding `0px 10px 0px 12px` · radius `8px` · weight `500`_

### Generic Card
```html
<div class="card">
  <!-- content -->
</div>
```
_Source pattern detected: padding `24px` · radius `0px` · shadow `none`_

**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** 3 · **cta** 1 · **docs** 1 · **social** 5 · **other** 1

**Primary actions (conversion path):**
- Primary call-to-action — "Get Started" (the conversion path) → `https://hono.dev/docs/`

**Signals:** 1/11 links carry a featured image · device mockups detected: tablet ×1 · dominant link roles: social-link (5), navigation (3), inline-link (2).


---
## Extraction Completeness: 66/100 (C)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 13 | 25 | 9 named colors |
| Typography | 20 | 20 | 9 roles defined |
| Components | 8 | 20 | 2 specs extracted |
| Motion & Interaction | 10 | 15 | Keyframes |
| CSS Custom Properties | 10 | 10 | 311 vars |
| Responsive Breakpoints | 5 | 5 | 6 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.

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Form inputs** | No text input fields detected on this page | Use the documented border-radius + accent border on focus; 12-16px padding inside |

### Per-section confidence

| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 311 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 9 typography roles inferred |
| §4 Components | Low | 2 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 17 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | High | 1 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 (66KB total). When running `prism add`, fonts are saved to `extractions/hono.dev/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;
}
@font-face {
  font-family: 'Inter';
  /* src: url('/fonts/Inter.woff2') format('woff2'); */
  font-weight: 100 900;
  font-style: italic;
  font-display: swap;
}
@font-face {
  font-family: 'Punctuation SC';
  /* src: url('/fonts/Punctuation-SC.woff2') format('woff'); */
  font-weight: 400;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Punctuation SC';
  /* src: url('/fonts/Punctuation-SC.woff2') format('woff'); */
  font-weight: 500;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Punctuation SC';
  /* src: url('/fonts/Punctuation-SC.woff2') format('woff'); */
  font-weight: 600;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'Punctuation SC';
  /* src: url('/fonts/Punctuation-SC.woff2') format('woff'); */
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}
```

### Keyframe Animations (Intercepted from CSS)

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

```
@keyframes fade-in { ... }
```

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

```css
@keyframes fade-in{0%{opacity:0}
```
</details>

### Hover State CSS (Intercepted)

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

```css
.custom-block.info a:hover,.custom-block.info a:hover>code{color:var(--vp-c-brand-2)}

.custom-block.note a:hover,.custom-block.note a:hover>code{color:var(--vp-c-brand-2)}

.custom-block.tip a:hover,.custom-block.tip a:hover>code{color:var(--vp-c-tip-2)}

.custom-block.important a:hover,.custom-block.important a:hover>code{color:var(--vp-c-important-2)}

.custom-block.warning a:hover,.custom-block.warning a:hover>code{color:var(--vp-c-warning-2)}

.custom-block.danger a:hover,.custom-block.danger a:hover>code{color:var(--vp-c-danger-2)}

.custom-block.caution a:hover,.custom-block.caution a:hover>code{color:var(--vp-c-caution-2)}

.custom-block.details a:hover,.custom-block.details a:hover>code{color:var(--vp-c-brand-2)}

.custom-block a:hover{opacity:.75}

.vp-code-group label:hover{color:var(--vp-code-tab-hover-text-color)}

.vp-doc h1:hover .header-anchor,.vp-doc h1 .header-anchor:focus,.vp-doc h2:hover .header-anchor,.vp-doc h2 .header-anchor:focus,.vp-doc h3:hover .header-anchor,.vp-doc h3 .header-anchor:focus,.vp-doc h4:hover .header-anchor,.vp-doc h4 .header-anchor:focus,.vp-doc h5:hover .header-anchor,.vp-doc h5 .header-anchor:focus,.vp-doc h6:hover .header-anchor,.vp-doc h6 .header-anchor:focus{opacity:1}

.vp-doc a:hover{color:var(--vp-c-brand-2)}

.vp-doc a:hover>code{color:var(--vp-code-link-hover-color)}

.vp-doc [class*=language-]:hover .has-focused-lines .line:not(.has-focus){filter:blur(0);opacity:1}

.vp-doc [class*=language-]:hover>button.copy,.vp-doc [class*=language-]>button.copy:focus{opacity:1}

.vp-doc [class*=language-]>button.copy:hover,.vp-doc [class*=language-]>button.copy.copied{border-color:var(--vp-code-copy-code-hover-border-color);background-color:var(--vp-code-copy-code-hover-bg)}

.vp-doc [class*=language-]>button.copy.copied,.vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 4px 4px 0;background-color:var(--vp-code-copy-code-hover-bg);background-image:var(--vp-icon-copied)}

.vp-doc [class*=language-]>button.copy.copied:before,.vp-doc [class*=language-]>button.copy:hover.copied:before{position:relative;top:-1px;transform:translate(calc(-100% - 1px));display:flex;justify-content:center;align-items:center;border:1px solid var(--vp-code-copy-code-hover-border-color);border-right:0;border-radius:4px 0 0 4px;padding:0 10px;width:fit-content;height:40px;text-align:center;font-size:12px;font-weight:500;color:var(--vp-code-copy-code-active-text);background-color:var(--vp-code-copy-code-hover-bg);white-space:nowrap;content:var(--vp-code-copy-copied-text-content)}

.vp-doc [class*=language-]:hover>button.copy+span.lang,.vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:0}
```

> **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 139 rendered nodes** — not a sample. These are the values the page *actually paints*, weighted by how often they appear.

### Real Responsive Breakpoints
**8 breakpoints** read from the live `@media` rules (not guessed):
`375px` · `639px` · `640px` · `767px` · `768px` · `960px` · `1280px` · `1440px`

### Measured Design Scale
**Type scale by usage** (× = paint count): `16px`×79 · `14px`×27 · `24px`×10 · `13.3333px`×9 · `12px`×6 · `56px`×4 · `13px`×2

**Radius scale** (× = paint count): `6px`×8 · `20px`×4 · `12px`×4 · `8px`×3 · `50%`×3 · `4px`×1 · `11px`×1

**Weights** (× = paint count): `400`×78 · `500`×36 · `700`×20 · `600`×4

**Elevation (real shadows)**:
```css
rgba(0, 0, 0, 0.1) 0px 12px 32px 0px, rgba(0, 0, 0, 0.08) 0px 2px 6px 0px
rgba(0, 0, 0, 0.04) 0px 1px 2px 0px, rgba(0, 0, 0, 0.06) 0px 1px 2px 0px
```

### 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 { font-family:var(--vp-font-family-base); font-size:16px; font-weight:400; color:var(--vp-c-text-1); background-color:var(--vp-c-bg) }
header { transition:background-color .5s }
h2 { font-weight:700!important }
h2 { font-size:16px; font-weight:600 }
button { background:var(--docsearch-searchbox-background); border-radius:40px; color:var(--docsearch-muted-color); font-weight:500 }
button { background:transparent; transition:border-color .25s; background-color:transparent }
@media (min-width: 768px) button { border-radius:8px; background-color:var(--vp-c-bg-alt) }
button { background-color:var(--vp-c-bg-soft) }
a { border-radius:8px; font-size:12px; font-weight:700; color:var(--vp-c-brand-1); box-shadow:var(--vp-shadow-3); background-color:var(--vp-c-bg) }
```

> 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://hono.dev | 2026-06-11T06:10:08.394Z*
*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.*