---
version: alpha
name: upstash.com
description: "Light product system built on #f5f5f5 with #00bc7d as the primary CTA accent. Type anchored in __Inter_Tight_a3c0d3 at 128px / weight 700. Extracted automatically from https://upstash.com/ — rendered styles via getComputedStyle() + CSS custom properties (token-only values may not be painted)."
narrative: |
upstash.com is built on a mid-dark canvas (oklch(0.97 0 0)).
The system uses rgb(0, 188, 125) as the high-saturation accent for primary actions.
Sharp 0px corners on CTAs — architectural restraint, engineering precision alongside __Inter_Tight_a3c0d3 as the primary typeface.
__Inter_Tight_a3c0d3 is paired with __Inter_Fallback_f367f3 for secondary roles.
A layered elevation system (7 distinct shadows) building a clear front-to-back hierarchy.
Motion is a first-class concern — 6 keyframe animations plus transition-driven interactions.
colors:
background: "#f5f5f5"
surface-1: "#ffffff"
surface-2: "rgba(255, 255, 255, 0.6)"
ink: "#022c22"
ink-muted: "rgba(2, 44, 34, 0.65)"
ink-subtle: "#022c22"
primary: "#00bc7d"
on-primary: "#111111"
primary-hover: "#6ee7b7"
hairline: "#e4e4e7"
primary-focus: "#101010"
typography:
display-xl:
fontFamily: "intercom-font, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
fontSize: 128px
fontWeight: 700
lineHeight: 1
letterSpacing: -3.2px
display-md:
fontFamily: "intercom-font, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
fontSize: 48px
fontWeight: 600
lineHeight: 1
letterSpacing: 0
headline:
fontFamily: "intercom-font, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
fontSize: 180px
fontWeight: 700
lineHeight: 1.25
letterSpacing: 0
body:
fontFamily: "intercom-font, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
fontSize: 14px
fontWeight: 400
lineHeight: 1.43
letterSpacing: 0
button:
fontFamily: "intercom-font, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
fontSize: 16px
fontWeight: 500
lineHeight: 1.5
letterSpacing: 0
rounded:
none: 0px
xs: 6px
sm: 8px
md: 12px
lg: 16px
xl: 35px
pill: 9999px
spacing:
xxs: 2px
xs: 6px
sm: 8px
md: 16px
lg: 64px
xl: 80px
xxl: 112px
components:
button-pill:
backgroundColor: "transparent"
textColor: "#71717b"
typography: "{typography.button}"
rounded: "{rounded.pill}"
padding: 8px 12px
button-pill-2:
backgroundColor: "transparent"
textColor: "#71717b"
typography: "{typography.button}"
rounded: "{rounded.pill}"
padding: 8px 16px
button-primary-brand:
backgroundColor: "{colors.primary}"
textColor: "{colors.surface-2}"
typography: "{typography.button}"
rounded: "{rounded.md}"
padding: 8px 32px
card-standard-card:
backgroundColor: "#047857"
typography: "{typography.button}"
rounded: "{rounded.lg}"
padding: 32px
extracted_at: "2026-06-11T06:19:37.141Z"
completeness: 69
scoreVersion: "v2"
---
# Design System — upstash.com
> Extracted automatically by Prism from https://upstash.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**: subtle | **Weight**: heavy | **Aesthetic**: product-neutral
| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (__Inter_f367f3) | "Serverless Data Platform" |
| Color assertion | dual-accent | #00bc7d |
| Whitespace | sparse | section rhythm 96px |
| Interaction | subtle | 6 keyframes, 6 transitions |
| Radius language | 12px-rounded | from token scale |
**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · 12px-rounded · subtle-motion`
> **🤖 TL;DR for AI agents** (read this first — saves you scanning the full doc):
>
> - **Canvas**: `oklch(0.97 0 0)` is the page background. Every component composits against this.
> - **Accent**: `rgb(0, 188, 125)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 96px between major bands. Card padding: 64px.
> - **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
upstash.com sits on a off-white canvas (`#f5f5f5`), a neutral foundation calibrated for sustained reading and component contrast.
Headlines are set in **__Inter_Tight_a3c0d3**, a sans-serif display face (the dominant type signature, e.g. "Serverless Data Platform" at 128px). A second display voice — **__Inter_f367f3** (sans) — appears in lower bands (e.g. "The single platform for all your data needs"), used for editorial accent. Body text is set in **__Inter_f367f3**. Headlines use weight 700 for confident, assertive presence — the brand wants to be heard. Negative letter-spacing at display sizes (-3.2px at 128px) compresses headlines into engineered blocks, dense and precise.
Body text reads in Deep Navy (`#022c22`) — softened from pure black, a small but deliberate detail that lowers reading friction. **Emerald** (`#00bc7d`) is the single high-saturation color in the system — it earns its presence only on interactive elements, making CTAs and links the unmistakable focal points against the otherwise neutral palette. Elevation is built from multi-layer shadow stacks (7 distinct) — each combines several blurred layers at varying offsets to build a clear front-to-back hierarchy.
Border radius varies from pill-shaped (fully rounded) to moderately rounded elements, creating visual rhythm. Motion design uses smooth easing curves for polished state transitions.
**Key Characteristics:**
- Background: Off-White (`#f5f5f5`)
- Primary typeface: intercom-font
- Primary text: Deep Navy (`#022c22`)
- Accent: Emerald (`#00bc7d`)
- Display: 128px weight 700, letter-spacing -3.2px
- Shadow system: 7 distinct elevation levels
- Custom fonts loaded: intercom-font
## 2. Color Palette & Roles
### Background & Surface
- **Off-White** (`#f5f5f5`): Page background (primary)
- **Whitesmoke** (`#e5e7eb`): Surface / elevated background
- **Whitesmoke** (`#e4e4e7`): Surface / elevated background
- **Pure White** (`#ffffff`): Surface / elevated background
- **Soft Pink** (`#e9d5ff`): Surface / elevated background
### Text & Content
- **Text** (`#022c22`): Primary body text
- **Pure Black** (`#000000`): Secondary text
- **Near-Black** (`#27272a`): Secondary text
- **Charcoal** (`#3d3d3f`): Secondary text
- **Pure Black** (`#09090b`): Secondary text
### Accent & Interactive
- **Bg Mute** (`rgba(4, 120, 87, 0.08)`): Accent / interactive (CSS var)
- **#6ee7b7** (`#6ee7b7`): Interactive / accent
- **Emerald** (`#10b981`): Interactive / accent
- **#34d399** (`#34d399`): Interactive / accent
- **M Tricolor Red** (`#dc2626`): Interactive / accent
- **#f97316** (`#f97316`): Interactive / accent
- **M Tricolor Blue** (`#2563eb`): Interactive / accent
### Full Extracted Palette
**23 colors rendered on the page** + **2** more declared in design tokens (CSS custom properties — not necessarily painted). (17 categorized above + 8 additional below.)
Rendered values are read via `getComputedStyle()`; token values come from CSS variable declarations. Third-party logo colors are filtered out.
- `#9333ea` — Violet
- `#065f46` — #065f46
- `#999999` — Grey
- `#f59e0b` — #f59e0b
- `#f6821f` — #f6821f
- `#fbad41` — #fbad41
- `#ff282d` — M Tricolor Red
- `rgba(59, 130, 246, 0.5)` — Translucent Ring Blue (50%) *(token)*
### Gradients & Decorative Fills
- `linear-gradient(to right, oklch(0.508 0.118 165.612), oklch(0.696 0.17 162.48), rgb(245, 158, 11))` — (heading)
### CSS Custom Properties (Design Tokens)
**Shadow Token**
- `--tw-ring-offset-shadow`: `0 0 #0000`
- `--tw-ring-shadow`: `0 0 #0000`
- `--tw-shadow`: `0 0 #0000`
- `--tw-shadow-colored`: `0 0 #0000`
**Text Color**
- `--color-text-mute`: `oklch(0.552 0.016 285.938)`
- `--color-text`: `#022c22`
**Background**
- `--color-bg`: `oklch(0.97 0 0)`
- `--color-bg-mute`: `rgba(4,120,87,.08)`
**Primary Brand Color**
- `--color-primary`: `oklch(0.696 0.17 162.48)`
- `--color-primary-text`: `oklch(0.508 0.118 165.612)`
**Spacing Token**
- `--tw-numeric-spacing`: ``
- `--tw-border-spacing-x`: `0`
- `--tw-border-spacing-y`: `0`
**Other tokens**
- `--tw-ring-offset-color`: `#fff`
- `--font-sans`: `"__Inter_f367f3","__Inter_Fallback_f367f3"`
- `--font-display`: `"__Inter_Tight_a3c0d3","__Inter_Tight_Fallback_a3c0d3"`
- `--tw-ring-color`: `rgba(59,130,246,.5)`
- `--color-pre-bg`: `#09090b`
## 3. Typography Rules
### Font Families
- **Primary**: `intercom-font`
- **Secondary**: `system-ui`
### Custom Fonts Loaded
- **__Inter_f367f3** weight 100 900 (normal)
- **__Inter_Fallback_f367f3** weight normal (normal)
- **__Inter_Tight_a3c0d3** weight 100 900 (normal)
- **__Inter_Tight_Fallback_a3c0d3** weight normal (normal)
- **__JetBrains_Mono_3c557b** weight 100 800 (normal)
- **__JetBrains_Mono_Fallback_3c557b** weight normal (normal)
- **intercom-font** weight normal (normal)
- **intercom-font** weight bold (normal)
### Typography Hierarchy
| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Label Heading | intercom-font | 180px | 700 | 1.25 | normal | Small heading (H5) |
| Display Hero | intercom-font | 128px | 700 | 1 | -3.2px | Main headline (h1) |
| Sub-heading | intercom-font | 48px | 600 | 1 | normal | Third-level heading (h3) |
| Label Heading | intercom-font | 24px | 600 | 1.33 | normal | Small heading (H4) |
| Card Title | intercom-font | 16px | 400 | 1.5 | normal | Card headings |
| Button Large | intercom-font | 16px | 500 | 1.5 | normal | Button label (16px) |
| Button | intercom-font | 14px | 400 | 1.43 | normal | Button label (14px) |
### Full Font Size Scale
Sizes detected in the design (descending): `180px`, `128px`, `48px`, `30px`, `24px`, `21.60px`, `20px`, `18px`, `16px`, `14px`, `13.76px`, `13px`, `12px`
> 7 size(s) detected outside the sampled hierarchy (30px, 21.6px, 20px, 18px, 13.76px, 13px, 12px). 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
**Pill**
- Background: `transparent`
- Text: `#71717b`
- Padding: 8px 12px
- Radius: 9999px
- Font: 16px weight 400
- Use: Status pills, tags, chips
- Focus: outline: `rgb(16, 16, 16) auto 1px`
**Pill**
- Background: `transparent`
- Text: `#71717b`
- Padding: 8px 16px
- Radius: 9999px
- Font: 16px weight 400
- Use: Status pills, tags, chips
- Focus: outline: `rgb(16, 16, 16) auto 1px`
**Primary Brand**
- Background: `#00bc7d` `{colors.primary}`
- Text: `#ffffff` `{colors.surface-2}`
- Padding: 8px 32px
- Radius: 12px
- Font: 16px weight 500
- Use: Primary CTA / brand action
- Focus: outline: `rgb(16, 16, 16) auto 1px`
**Light / Invert**
- Background: `#ffffff` `{colors.surface-2}`
- Text: `#dc2626`
- Padding: 0px 32px
- Radius: 16px 16px 0px 0px
- Font: 24px weight 600
- Use: Bright CTA on dark sections
- Focus: outline: `rgb(16, 16, 16) auto 1px`
**Light / Invert**
- Background: `#f5f5f5` `{colors.background}`
- Text: `#71717b`
- Padding: 0px 32px
- Radius: 16px 16px 0px 0px
- Font: 24px weight 600
- Use: Bright CTA on dark sections
- Focus: outline: `rgb(16, 16, 16) auto 1px`
**Primary Brand**
- Background: `#00bc7d` `{colors.primary}`
- Text: `#ffffff` `{colors.surface-2}`
- Padding: 8px 20px
- Radius: 12px
- Font: 16px weight 500
- Use: Primary CTA / brand action
- Focus: outline: `rgb(16, 16, 16) auto 1px`
### Cards & Containers
**Standard Card**
- Background: `rgba(4, 120, 87, 0.08)`
- Padding: 32px
- Radius: 16px
- Use: Content containers, listing items
## 4b. Component Behaviors (State Matrix)
### Interaction State Narrative
- **Link**:
- **hover:** text #6ee7b7 → #00bc7d
- **NavLink**:
- **hover:** text #6ee7b7 → #00bc7d
- **FooterLink**:
- **hover:** text #71717b → #00bc7d
*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(228, 228, 231)"
focus:
bg: "transparent"
fg: "inherit"
link:
default:
bg: "rgba(0, 0, 0, 0)"
fg: "rgb(110, 231, 183)"
hover:
bg: "transparent"
fg: "oklch(0.696 0.17 162.48)"
card:
default:
bg: "rgba(4, 120, 87, 0.08)"
fg: "rgb(2, 44, 34)"
navLink:
default:
bg: "rgba(0, 0, 0, 0)"
fg: "rgb(110, 231, 183)"
hover:
bg: "transparent"
fg: "oklch(0.696 0.17 162.48)"
footerLink:
default:
bg: "rgba(0, 0, 0, 0)"
fg: "oklch(0.552 0.016 285.938)"
hover:
bg: "transparent"
fg: "oklch(0.696 0.17 162.48)"
```
**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: `Pill`, `Primary Brand`, `Light / Invert`
- **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
1200px
### Spacing System
Generous spacing — editorial breathing room
| Token | Value |
|-------|-------|
| xxs | 2px |
| xs | 6px |
| sm | 8px |
| md | 16px |
| base | 32px |
| lg | 64px |
| xl | 80px |
| 2xl | 96px |
| 3xl | 112px |
### 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 | 16px | Large rounded elements, pill segments |
| Xl | 35px | Category strips, featured containers |
| Full | 9999px | Pills, avatars, circular elements |
### Shape Language
| Component | Border Radius |
|-----------|---------------|
| Buttons | `9999px` |
| Cards & Containers | `16px` |
| Page Body | `0px` |
| Navigation | `0px` |
**Shape Personality**: Sharp + Pill Contrast — Angular precision with pill-shaped accents (status badges, tags). Creates strong visual hierarchy.
**Full Radius Spectrum**: 0px, 6px, 8px, 12px, 16px, 24px, 35px, 35.2px (from `allBorderRadii` scan)
## 5b. Spacing Rhythm Names
**Measured section padding**: bands use ~96px internal vertical padding (up to 112px) — **very airy / premium**. (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** | `112px` | Top/bottom of full-bleed hero sections |
| **section** | `80px` | Between major bands (color change, content shift) |
| **subsection** | `64px` | Within a section, between content groups |
| **card** | `16px` | Card padding, list-item spacing |
| **compact** | `8px` | Form fields, tight clusters, badge padding |
| **micro** | `6px` | 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).
**5/8 structural patterns detected.**
### Hero Pattern
- **Composition:** centered — Centered composition — heading + subheading + CTAs stacked vertically, content centered horizontally. Common for SaaS marketing pages.
- **Viewport coverage:** 488px tall (not full-viewport)
- **Heading:** "Serverless Data Platform" — 128px center-aligned
- **Subheading:** "The single platform for all your data needs"
- **CTAs:** 1 (primary: "Start for Free")
- **Clone instruction:** Reproduce the **centered** 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:** 40px
- **Logo:** ✗ absent
- **Nav links:** 5 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:** 11 cards detected
- **Columns (desktop):** 1-up grid
- **Card dimensions:** 1200×220px (aspect 5.45:1)
- **Gap:** 0px between cards
- **Content:** ✗ no image + icon
- **Clone instruction:** Build a 1-column grid (desktop) with cards at ~5.45:1 aspect ratio. Text/icon-only cards (no photography).
### Pricing Table Pattern
- **Tier count:** 2 pricing tiers
- **Layout:** vertical stacked
- **Columns (desktop):** 2-up
- **Clone instruction:** Build a 2-column vertical-stack pricing comparison.
### Footer Pattern
- **Columns:** 1
- **Links:** 6 total
- **Height:** 550px
- **Includes:** ✗ no newsletter | ✗ no social | ✓ copyright
- **Clone instruction:** Build a 1-column footer with ~6 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) |
`rgba(0, 0, 0, 0.05) 0px 1px 2px 0px` | Cards, elevated surfaces |
| Layered (Level 2) |
`rgba(0, 0, 0, 0.25) 0px 25px 50px -12px` | Cards, elevated surfaces |
| Layered (Level 3) |
`rgba(0, 0, 0, 0.1) 0px 1px 3px 0px`,
`rgba(0, 0, 0, 0.1) 0px 1px 2px -1px` | Cards, elevated surfaces |
| Layered (Level 4) |
`rgba(16, 185, 129, 0.3) 0px 0px 80px 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
### Dominant Easing Curves
| Curve | Semantic Name |
|-------|---------------|
| `cubic-bezier(0.4,0,0.2,1)` | Material Standard — Balanced |
| `cubic-bezier(0.4,0,1,1)` | Material Accelerate — Exit |
### Duration Scale
| Value | Tier | Typical Use |
|-------|------|-------------|
| `150ms` | Fast | Hover states, micro-interactions |
| `300ms` | Normal | Panel open/close, navigation |
### Copy-Paste Transition Snippets
**Transform**
```css
transition: transform 0.15s cubic-bezier(0.4, 0, 1, 1);
```
**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...;
```
**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...;
```
**All Props**
```css
transition: 0.3s cubic-bezier(0.4, 0, 0.2, 1);
```
### Keyframe Animation Catalog
| Animation Name | Type | Animated Props | Use Hint |
|----------------|------|----------------|----------|
| `headShake` | Rotate / Spin | transform | Error feedback |
| `heartBeat` | Scale | transform | UI transition |
| `pulse` | Fade | opacity | Attention / status |
| `animate-slide` | Slide | transform | UI transition |
| `animate-gradient` | Custom | background-position-x, background-position-y | UI transition |
| `launcherEnter` | Fade + Move | transform, opacity | Element entrance |
### Motion Fingerprint
- **Speed Character**: Deliberate & Calm (median duration: `300ms`)
- **Dominant Easing**: custom cubic-bezier curves
- **Animation Library**: 6 unique animations (6 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 Off-White (`#f5f5f5`) as the page background — it's intentionally not pure white
- Use Text (`#022c22`) for text — not pure black, it's warmer and more readable
- Use negative letter-spacing (-3.2px) at display sizes for compressed, editorial headlines
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use full-pill radius (9999px) only for specific elements (avatars, pills, toggles)
- Use Primary (`#00bc7d`) as the primary accent — it's the brand's signature interactive color
- Use 12px border-radius on buttons — the standard corner rounding for interactive elements
- Apply 32px padding inside cards — matches the design system's content breathing room
- Use 16px border-radius on cards — consistent with the grid card corners
- Maintain nav height at 40px — consistent vertical space for the navigation bar
- Respect the 6px–80px spacing range — the design uses a wide scale for visual breathing room
- Use a single primary CTA in the hero — the design intentionally avoids choice paralysis
- Each card uses an icon (not photo) — the visual language is illustrative, not photographic
### 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 increase letter-spacing on headings — the type is designed to run tight at scale
- Don't invent new shadow values — use only the extracted shadow levels
- Don't apply pill radius on rectangular buttons or cards — it's reserved for specific interactive elements
- 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 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, 6 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 `oklch(0.97 0 0)` as the base canvas"
why: "Every component is designed to composit against this exact tone"
test: "document.body.style.backgroundColor === 'oklch(0.97 0 0)'"
- id: brand-accent-001
type: do
rule: "Reserve `rgb(0, 188, 125)` for primary CTAs and brand-mark signals only"
why: "Single chromatic assertion device — overuse dilutes meaning"
test: "querySelectorAll('[style*=\"rgb(0, 188, 125)\"]').length <= 3 per fold"
```
## 9. Responsive Behavior
### Breakpoints
| Name | Width | Key Changes |
|------|-------|-------------|
| Mobile | 420px | Single column, compact spacing |
| Mobile Large | 640px | Expanded mobile layout |
| Tablet | 768px | Multi-column grids begin |
| Tablet | 1024px | Multi-column grids begin |
| Desktop | 1280px | Full feature layout |
| Large Desktop | 1536px | Maximum content width |
### Token Diff — Desktop vs Mobile
| Element | Property | Desktop | Mobile |
|---------|----------|---------|--------|
| heading | font-size | `128px` | `48px` |
| heading | line-height | `128px` | `48px` |
| heading | letter-spacing | `-3.2px` | `-1.2px` |
| body | font-size | `16px` | `14px` |
| body | line-height | `24px` | `20px` |
| body | padding | `80px 0px 0px` | `70px 0px 0px` |
| nav | height | `40px` | `auto` |
| button | width | `20px` | `auto` |
| card | padding | `32px` | `24px` |
| card | width | `357.328px` | `342px` |
### Collapsing Strategy
- Headlines: 128px → 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: 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):
*No major structural differences detected between desktop and mobile widgets. The same blueprints scale rather than collapse — verify by inspecting 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 (10)
## 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://upstash.com/og-home.jpg
*This is the image shown when the site is shared on social media — represents the brand visual essence.*
**Aspect Ratio Distribution:**
- Landscape (1.15–2.3): 0 (0%)
- Portrait (<0.87): 0 (0%)
- Square (0.87–1.15): 1 (100%)
**Media Format Mix:**
- WebP: 1 (optimized photo/illustration hybrid)
- SVG: 1 (icons, illustrations, decorative geometry)
**Average rendered image size:** 1440×1440px
**Above-fold image count:** 0 / 1
**Decorative Patterns Detected:**
- 1 multi-stop linear gradient (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:** Glassmorphism is a brand signature — use `backdrop-filter: blur(20px)` on overlapping surfaces.
**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: Off-White (`#f5f5f5`)
- Primary text: Deep Navy (`#022c22`)
- Accent: Emerald (`#00bc7d`)
- Border: Whitesmoke (`#e4e4e7`)
- Font: intercom-font
- Body: 16px weight 400
### Example Component Prompts
- "Create a hero section on Off-White background (#f5f5f5). Headline at 128px intercom-font weight 700, line-height 1, letter-spacing -3.2px, color #022c22."
- "Create the primary CTA button: `#00bc7d` background, `#007a55` text, 12px border-radius, 8px 16px padding, 500 weight, intercom-font font."
- "Design a card on `rgba(4, 120, 87, 0.08)` background. Border: none. Radius: 16px. Shadow: none. Padding: 32px."
- "Build navigation: relative on `#f5f5f5`. intercom-font 16px weight 400 for links."
### Iteration Guide
1. **Canvas**: Set the light canvas to Off-White (`#f5f5f5`) — every component is composited against this exact base.
2. **Typography**: All type in intercom-font, weight range 400–700. Never exceed 700 — heavier weights break the brand's tonal restraint.
3. **Accent**: Emerald (`#00bc7d`) is the sole interactive color. On hover → #6ee7b7 (`#6ee7b7`). Use CSS transitions, not opacity/brightness filters.
4. **Motion**: All transitions use `cubic-bezier(0.4,0,1,1)`. Never use linear for UI transitions — preserve the brand's easing personality.
5. **Shape**: CTAs at `0px`, cards at `16px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
6. **Spacing**: Use the `--ca-space-*` token scale (6px–80px). 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: #f5f5f5;
--ca-surface-2: #ffffff;
--ca-ink-subtle: #022c22;
--ca-primary: #00bc7d;
--ca-on-primary: #111111;
--ca-primary-hover: #6ee7b7;
--ca-hairline: #e4e4e7;
--ca-primary-focus: #101010;
}
/* Typography */
:root {
--ca-font-primary: "intercom-font", system-ui, sans-serif;
--ca-text-display: 128px;
--ca-text-body: 14px;
--ca-text-button: 16px;
}
/* Spacing & Radius */
:root {
--ca-space-xxs: 2px;
--ca-space-xs: 6px;
--ca-space-sm: 8px;
--ca-space-md: 16px;
--ca-space-base: 32px;
--ca-space-lg: 64px;
--ca-space-xl: 80px;
--ca-space-2xl: 96px;
--ca-space-3xl: 112px;
--ca-radius-none: 0px;
--ca-radius-xs: 6px;
--ca-radius-sm: 8px;
--ca-radius-md: 12px;
--ca-radius-lg: 16px;
--ca-radius-xl: 35px;
--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: header
tag: header
classes: ["fixed", "inset-x-0", "top-0", "z-50"]
height: 125px
width: full-bleed
layout: block
children: 2
- section: hero
tag: main
classes: ["text-center"]
height: 4916px
width: full-bleed
layout: block
children: 7
vertical-padding: ~112px (airy)
- section: feature-section
tag: section
classes: ["relative", "z-0", "py-16"]
height: 488px
width: full-bleed
layout: block
children: 2
vertical-padding: ~64px (generous)
padding: "64px 0px"
- section: feature-section
tag: section
classes: ["relative", "z-10", "sm:mt-4"]
height: 1024px
width: full-bleed
layout: block
children: 1
- section: section
tag: section
classes: ["relative", "-z-10", "mt-20", "h-[320px]"]
height: 500px
width: full-bleed
layout: block
children: 6
- section: feature-section
tag: section
classes: ["relative", "z-10", "py-16", "md:mt-20"]
height: 1192px
width: full-bleed
layout: block
children: 2
vertical-padding: ~112px (airy)
padding: "112px 0px"
- section: header
tag: header
classes: ["mx-auto", "max-w-screen-md"]
height: 88px
width: 768px
layout: block
children: 2
- section: header
tag: header
height: 100px
width: 524px
layout: block
children: 2
- section: header
tag: header
height: 92px
width: 524px
layout: block
children: 2
- section: header
tag: header
height: 92px
width: 728px
layout: block
children: 2
- section: header
tag: header
classes: ["relative", "z-20"]
height: 92px
width: 320px
layout: block
children: 2
- section: feature-section
tag: section
classes: ["relative", "z-10", "py-8", "md:py-16"]
height: 888px
width: full-bleed
layout: block
children: 2
vertical-padding: ~64px (generous)
padding: "64px 0px"
- section: header
tag: header
classes: ["mx-auto", "max-w-screen-md"]
height: 120px
width: 768px
layout: block
children: 2
- section: feature-section
tag: section
classes: ["relative", "z-10", "py-8", "md:py-16"]
height: 600px
width: full-bleed
layout: block
children: 2
vertical-padding: ~64px (generous)
padding: "64px 0px"
- section: header
tag: header
classes: ["mx-auto", "max-w-screen-md"]
height: 88px
width: 768px
layout: block
children: 2
- section: footer
tag: footer
classes: ["relative", "z-20", "py-24", "text-center"]
height: 550px
width: full-bleed
layout: block
children: 1
vertical-padding: ~96px (airy)
padding: "96px 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 single platform for all your data needs"
- "Low-latency, serverless key-value store"
sub-headings:
- "Serverless & Edge"
ctas:
- "Docs"
- "Pricing"
- "Login"
- "Start for Free"
- "Redis ®*"
- "Vector"
- "Learn more"
- "Documentation"
navigation:
- "Upstash"
- "Terms"
- "Privacy Policy"
- "Data Protection Agreement"
- "Docs"
- "Pricing"
- "Customers"
- "Enterprise"
- "Blog"
- "Login"
footer-links:
- "Contact Us"
- "Privacy Policy"
- "Status"
- "https://upstash.com/start-redis"
```
**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:
thumbnail:
count: 1
avg-ratio: 1.00
common-aspect: "~1:1 square"
sample-alts:
- "lagon logo"
```
**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` · radius `0px` · weight `400`_
### Generic Card
```html
```
_Source pattern detected: padding `32px` · radius `16px` · 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** 2 · **auth** 1 · **pricing** 2 · **docs** 4 · **blog** 2 · **project** 18 · **social** 2 · **footer** 5 · **download** 5 · **other** 4
**Primary actions (conversion path):**
- Account access — "Login" (login/signup) → `https://console.upstash.com/`
**Projects / case studies detected** (clustered by URL + featured image):
*Customers* — high confidence, 11 items:
| Title | Featured image | Link |
|---|---|---|
| "At our scale, it's important to use the rig | — | https://upstash.com/customers/supabase |
| "Upstash's global Redis has been a game chan | — | https://upstash.com/customers/paul-smith |
| "Developer experience became significantly b | — | https://upstash.com/customers/openart |
| "The Upstash JS SDK is incredibly easy to us | — | https://upstash.com/customers/dub |
| "We chose Upstash specifically because it of | — | https://upstash.com/customers/zapier |
| "Before Upstash we used Redis Cloud. This wa | — | https://upstash.com/customers/branch |
| "Before Upstash QStash, we struggled with up | — | https://upstash.com/customers/humata |
| "We were using Redis before for our cache bu | — | https://upstash.com/customers/gail |
*Docs* — medium confidence, 3 items:
| Title | Featured image | Link |
|---|---|---|
| Documentation | — | https://upstash.com/docs/redis |
| Restapi | — | https://upstash.com/docs/redis/features/restapi |
| Globaldatabase | — | https://upstash.com/docs/redis/features/globaldatabase |
**Signals:** 29/45 links carry a featured image · dominant link roles: content-card (25), footer-link (9), inline-link (9).
---
## Extraction Completeness: 69/100 (C)
| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 24 | 25 | 17 named colors |
| Typography | 18 | 20 | 7 roles defined |
| Components | 8 | 20 | 2 specs extracted |
| Motion & Interaction | 12 | 15 | Keyframes |
| CSS Custom Properties | 3 | 10 | 61 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_f367f3, __Inter_Tight_a3c0d3, __JetBrains_Mono_3c557b)** — 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 |
|----------|----------------|-------------------|
| **Hero imagery** | No dominant hero image detected above the fold | Use the canonical brand visual from §9b (OG image) for hero composition |
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |
| **Form inputs** | No text input fields detected on this page | Use the documented border-radius + accent border on focus; 12-16px padding inside |
### Per-section confidence
| Section | Confidence | Reason |
|---------|------------|--------|
| §1 Visual Theme | High | Body bg extracted via getComputedStyle() |
| §2 Colors | High | 61 CSS vars (semantic naming requires ≥20 for high) |
| §3 Typography | High | 7 typography roles inferred |
| §4 Components | Low | 2 component variants captured |
| §7 Motion | High | Keyframes + transitions |
| §8 Do's/Don'ts | High | 23 rules generated; design-decisions.json has evidence per rule |
| §9 Responsive | High | 6 breakpoints detected |
| §9b Photography | Medium | 1 images, hero not detected |
## 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 `