figma-n4pzjScBY5cqrPlmM9KoK2

DESIGN.md

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

---
version: alpha
name: figma-n4pzjScBY5cqrPlmM9KoK2
description: "Light product system built on #ffffff with #b9ff66 as the primary CTA accent. Type anchored in Space Grotesk at 60px / weight 500. Extracted from the Figma file via the Figma REST API — exact fills, type styles, effects, and auto-layout spacing read straight from the design source of truth (not a rendered approximation)."
narrative: |
  figma-n4pzjScBY5cqrPlmM9KoK2 is built on a pure-white canvas (rgb(255, 255, 255)).
  The system uses rgb(185, 255, 102) as the high-saturation accent for primary actions.
  Moderately rounded CTAs (14px) — modern SaaS standard, neither sharp nor pill alongside Space Grotesk as the primary typeface.
  A restrained elevation system (1 distinct shadow) — shadows reserved for the few elements that must lift off the page.

colors:
  background: "#ffffff"
  surface-1: "#f3f3f3"
  surface-2: "#f3f3f3"
  ink-subtle: "#191a23"
  primary: "#b9ff66"
  on-primary: "#111111"
  primary-hover: "#ff9900"
  hairline: "#d9d9d9"

typography:
  display-xl:
    fontFamily: "Space Grotesk, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 60px
    fontWeight: 500
    lineHeight: 1.28
    letterSpacing: 0
  display-lg:
    fontFamily: "Space Grotesk, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 40px
    fontWeight: 500
    lineHeight: 1.28
    letterSpacing: 0
  button:
    fontFamily: "Space Grotesk, 'SF Pro Display', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
    fontSize: 20px
    fontWeight: 400
    lineHeight: 1.4
    letterSpacing: 0

rounded:
  none: 0px
  xs: 7px
  sm: 14px
  md: 29px
  lg: 33px
  xl: 45px
  pill: 9999px

spacing:
  xxs: 2px
  xs: 5px
  sm: 7px
  md: 10px
  lg: 35px
  xl: 50px
  xxl: 100px

components:
  button-outline:
    backgroundColor: "transparent"
    textColor: "#000000"
    typography: "{typography.button}"
    rounded: "{rounded.sm}"
    padding: 20px 35px 20px 35px
  card-standard-card:
    backgroundColor: "{colors.surface-2}"
    typography: "{typography.button}"
    rounded: "{rounded.xl}"
    padding: 50px 50px 50px 50px
  navigation-main-nav:
    backgroundColor: "transparent"
    typography: "{typography.button}"
    rounded: "{rounded.none}"
    padding: 0px 100px 0px 100px

extracted_at: "2026-06-11T05:00:49.157Z"
completeness: 50
scoreVersion: "v2"

---

# Design System — figma-n4pzjScBY5cqrPlmM9KoK2
> Extracted automatically by Prism from https://www.figma.com/design/n4pzjScBY5cqrPlmM9KoK2/Positivus?m=auto
> Date: 2026-06-11
> Viewport: Desktop 1440x8356 + Mobile 390x844
> Values are extracted from the Figma REST API, not hand-written: exact fills, text styles, effects, and auto-layout spacing read straight from the design file (the source of truth, not a rendered approximation).


## 0. Design DNA

**Density**: sparse  |  **Motion**: still  |  **Weight**: light  |  **Aesthetic**: product-neutral

| Dimension | Value | Signal |
|---|---|---|
| Canvas | neutral | `#ffffff` |
| Type posture | sans-led (Space Grotesk) | "Navigating the digital landsca" |
| Color assertion | dual-accent | #b9ff66 |
| Whitespace | sparse | section rhythm 77px |
| Interaction | still | 0 keyframes, 0 transitions |
| Radius language | 14px-rounded | from token scale |

**Prism fingerprint**: `neutral-canvas · sans-display · dual-accent · 14px-rounded · still-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(185, 255, 102)` for primary CTAs ONLY. Never decorative.
> - **Body type**: 16px (token: `typography.body`). Default for ALL text not in a heading role.
> - **Section rhythm**: 77px between major bands. Card padding: 35px.
> - **Default radius**: 14px 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

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

Typography is anchored in **Space Grotesk**. 

Body text reads in Pure Black (`#000000`) (contrast ratio 21.0:1, well above WCAG AA). **#b9ff66** (`#b9ff66`) 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 comes from a small, deliberate set of shadows (1 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: Space Grotesk
- Accent: #b9ff66 (`#b9ff66`)
- Display: 60px weight 500
- Border: Light Grey (`#d9d9d9`) — border-based containment
- Shadow system: 1 distinct elevation levels
- Custom fonts loaded: Space Grotesk

## 2. Color Palette & Roles

### Background & Surface
- **Pure White** (`#ffffff`): Page background (primary)
- **Off-White** (`#f3f3f3`): Surface / elevated background
- **Light Grey** (`#d9d9d9`): Surface / elevated background

### Text & Content
- **Pure Black** (`#000000`): Primary body text
- **Near-Black** (`#191a23`): Secondary text
- **Deep Navy** (`#0d0c22`): Secondary text
- **Charcoal** (`#292a32`): Secondary text

### Accent & Interactive
- **#b9ff66** (`#b9ff66`): Interactive / accent
- **#ff9900** (`#ff9900`): Interactive / accent
- **Slate** (`#33475b`): Interactive / accent
- **Coral** (`#ff7a59`): Interactive / accent
- **M Tricolor Red** (`#d81f26`): Interactive / accent
- **Ring Blue** (`#2d8cff`): Interactive / accent

## 3. Typography Rules

### Font Families
- **Primary**: `Space Grotesk`

### Custom Fonts Loaded
- **Space Grotesk** weight undefined (undefined)

### Typography Hierarchy

| Role | Font | Size | Weight | Line Height | Letter Spacing | Notes |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | Space Grotesk | 60px | 500 | 1.28 | normal | Main headline (heading) |
| Section Heading | Space Grotesk | 40px | 500 | 1.28 | normal | Section titles (subheading) |
| Button Large | Space Grotesk | 20px | 400 | 1.4 | normal | Button label (20px) |

### Full Font Size Scale

Sizes detected in the design (descending): `60px`, `40px`, `30px`, `20px`, `18px`, `16px`

> 3 size(s) detected outside the sampled hierarchy (30px, 18px, 16px). 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

**Outline**
- Background: `transparent`
- Text: `#000000`
- Padding: 20px 35px 20px 35px
- Radius: 14px
- Border: 1px solid rgb(25, 26, 35)
- Font: 20px weight 400
- Use: Secondary action with border

### Cards & Containers

**Standard Card**
- Background: `#f3f3f3` `{colors.surface-2}`
- Padding: 50px 50px 50px 50px
- Radius: 45px
- Border: 1px solid rgb(25, 26, 35)
- Shadow: `rgb(25, 26, 35) 0px 5px 0px 0px`
- Use: Content containers, listing items

### Navigation

**Main Nav**
- Background: `transparent`
- Padding: 0px 100px 0px 100px
- Radius: none
- Font: 20px weight 400
- Use: Fixed/sticky flex nav — N/A items


## 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
- **1 shape(s)** in this system: `Outline`
- **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

### Navigation
- **1 shape(s)** in this system: `Main Nav`
- **DO NOT introduce new navigation 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 | 5px |
| sm | 7px |
| md | 10px |
| base | 20px |
| lg | 35px |
| xl | 50px |
| 2xl | 77px |
| 3xl | 100px |

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

### Shape Language

| Component | Border Radius |
|-----------|---------------|
| Buttons | `14px` |
| Cards & Containers | `45px` |
| Navigation | `none` |
| Page Body | `0px` |
| Primary Input | `0px` |

**Shape Personality**: Generously Rounded — Soft, friendly corners (8px+). Approachable, consumer-facing feel.

**Full Radius Spectrum**: 0px, 7px, 14px, 29px, 33px, 45px (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** | `100px` | Top/bottom of full-bleed hero sections |
| **section** | `50px` | Between major bands (color change, content shift) |
| **subsection** | `35px` | Within a section, between content groups |
| **card** | `10px` | Card padding, list-item spacing |
| **compact** | `7px` | Form fields, tight clusters, badge padding |
| **micro** | `5px` | 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:** centered — Centered composition — heading + subheading + CTAs stacked vertically, content centered horizontally. Common for SaaS marketing pages.
- **Viewport coverage:** 51px tall (not full-viewport)
- **Heading:** "Navigating the digital landscape for success" — 60px center-aligned
- **Subheading:** "Our Working Process "
- **Media:** present, positioned right
- **CTAs:** 1 (primary: "Request a quote")
- **Clone instruction:** Reproduce the **centered** layout. Use the heading font-size token at the documented size. Place media right of text.

### Navigation Pattern

- **Position:** sticky (stays visible during scroll)
- **Layout:** logo-left — 
- **Height:** 68px
- **Logo:** ✗ absent
- **Nav links:** 0 primary items
- **CTAs in nav:** 0 (no buttons — links only)
- **Clone instruction:** Build a sticky logo left navigation. Link-only — no button styling needed.

## 6. Depth & Elevation

| Level | Treatment | Use |
|-------|-----------|-----|
| Flat (Level 0) | No shadow | Page background, content blocks |
| Layered (Level 1) | <br>`rgb(25, 26, 35) 0px 5px 0px 0px` | Cards, elevated surfaces |

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

## 8. Do's and Don'ts

### Do
- Use Space Grotesk as the primary typeface — it defines the brand personality
- Keep font weights between 400-500 — the system uses a narrow weight range for subtle hierarchy
- Use the extracted shadow patterns for elevation — they are tuned to match the brand palette
- Use #b9ff66 (`#b9ff66`) as the primary accent — it's the brand's signature interactive color
- Apply 50px 50px 50px 50px padding inside cards — matches the design system's content breathing room
- Use 45px border-radius on cards — consistent with the grid card corners
- Style form inputs with a `none` border — use border-based inputs, not floating labels or underline-only
- Maintain nav height at 68px — consistent vertical space for the navigation bar
- Respect the 5px–50px 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
- Make the navigation sticky — it stays visible during scroll, signaling content depth

### Don't
- Don't substitute with generic sans-serif or serif — the custom font carries the brand
- Don't use weight 700 (bold) or above — 500 is the maximum weight in this system
- 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 remove the input border — the border is the primary affordance indicator for form fields
- Don't collapse or hide the nav on scroll without an explicit scroll-triggered animation — the design uses fixed nav presence


## 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(185, 255, 102)` for primary CTAs and brand-mark signals only"
    why: "Single chromatic assertion device — overuse dilutes meaning"
    test: "querySelectorAll('[style*=\"rgb(185, 255, 102)\"]').length <= 3 per fold"
```

## 9. Responsive Behavior

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

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

### Touch Targets
- Buttons: 20px 35px 20px 35px 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.*

## 9b. Visual Tone & Photography

**Tone:** Illustration-driven

The site relies primarily on illustrations, vector art, and decorative SVG elements rather than photography. Use commissioned illustrations, icon sets, or generated graphics for clones — stock photos will feel off-brand.

**Media Format Mix:**
- WebP: 6 (optimized photo/illustration hybrid)
- SVG: 69 (icons, illustrations, decorative geometry)

**Imagery Guidance for clones:**
- Use vector illustration as the primary visual language — photos will read as off-brand.
- Maintain consistent illustration style (line weight, color palette) across the site.

## 10. Agent Prompt Guide

### Quick Reference
- Background: Pure White (`#ffffff`)
- Primary text: Pure Black (`#000000`)
- Accent: #b9ff66 (`#b9ff66`)
- Border: Light Grey (`#d9d9d9`)
- Font: Space Grotesk
- Body: 16px weight 400

### Example Component Prompts
- "Create a hero section on Pure White background (#ffffff). Headline at 60px Space Grotesk weight 500, line-height 1.28, color #000000."
- "Create the primary CTA button: `#b9ff66` background, `#000000` text, 14px border-radius, 20px 35px 20px 35px padding, 500 weight, Space Grotesk font."
- "Design a card on `#f3f3f3` background. Border: 1px solid rgb(25, 26, 35). Radius: 45px. Shadow: use extracted shadow. Padding: 50px 50px 50px 50px."
- "Build navigation: relative on `#ffffff`. Space Grotesk 20px 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 Space Grotesk, weight range 400–500. Never exceed 500 — heavier weights break the brand's tonal restraint.
3. **Accent**: #b9ff66 (`#b9ff66`) — one accent, applied consistently to CTAs, active states, and links. Never introduce a second saturated color.
4. **Shape**: cards at `45px`. Apply border-radius from the extracted scale only — don't invent intermediate values.
5. **Spacing**: Use the `--ca-space-*` token scale (5px–50px). 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-surface-2: #f3f3f3;
  --ca-ink-subtle: #191a23;
  --ca-primary: #b9ff66;
  --ca-on-primary: #111111;
  --ca-primary-hover: #ff9900;
  --ca-hairline: #d9d9d9;
}

/* Typography */
:root {
  --ca-font-primary: "Space Grotesk", system-ui, sans-serif;
  --ca-text-display: 60px;
  --ca-text-heading: 40px;
  --ca-text-button: 20px;
}

/* Spacing & Radius */
:root {
  --ca-space-xxs: 2px;
  --ca-space-xs: 5px;
  --ca-space-sm: 7px;
  --ca-space-md: 10px;
  --ca-space-base: 20px;
  --ca-space-lg: 35px;
  --ca-space-xl: 50px;
  --ca-space-2xl: 77px;
  --ca-space-3xl: 100px;
  --ca-radius-none: 0px;
  --ca-radius-xs: 7px;
  --ca-radius-sm: 14px;
  --ca-radius-md: 29px;
  --ca-radius-lg: 33px;
  --ca-radius-xl: 45px;
  --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: section
    tag: div
    classes: ["Landing page"]
    height: 771px
    width: full-bleed
    layout: flex-column justify=normal
    children: 3
  - section: section
    tag: div
    classes: ["Services block"]
    height: 1010px
    width: full-bleed
    layout: flex-column justify=normal
    children: 3
  - section: cta
    tag: div
    classes: ["CTA block"]
    height: 394px
    width: full-bleed
    layout: block
    children: 1
  - section: section
    tag: div
    classes: ["Case studies block"]
    height: 326px
    width: 1434px
    layout: flex-column justify=normal
    children: 1
    padding: "0px 100px 0px 100px"
  - section: section
    tag: div
    classes: ["Process block"]
    height: 1224px
    width: 1434px
    layout: flex-column justify=normal
    children: 6
    padding: "0px 100px 0px 100px"
  - section: section
    tag: div
    classes: ["Group of cards"]
    height: 725px
    width: full-bleed
    layout: flex-column justify=normal
    children: 2
  - section: social-proof
    tag: div
    classes: ["Testimonials block"]
    height: 625px
    width: 1240px
    layout: block
    children: 1
    bg: "rgb(25, 26, 35)"
  - section: section
    tag: div
    classes: ["Contact block"]
    height: 773px
    width: full-bleed
    layout: flex-row justify=normal
    children: 2
    padding: "0px 100px 0px 100px"
  - section: footer
    tag: div
    classes: ["Footer block"]
    height: 514px
    width: full-bleed
    layout: flex-column justify=normal
    children: 1
    padding: "0px 100px 0px 100px"
```

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


---
## Extraction Completeness: 50/100 (D)

| Category | Score | Max | Detail |
|----------|-------|-----|--------|
| Colors & Palette | 18 | 25 | 13 named colors |
| Typography | 8 | 20 | 3 roles defined |
| Components | 12 | 20 | 3 specs extracted |
| Motion & Interaction | — | N/A | Not applicable — a static Figma file has no animation |
| CSS Custom Properties | 0 | 10 | 0 vars (enable token scope file_variables:read to capture Figma Variables) |
| Responsive Breakpoints | — | N/A | Not applicable — single design frame, no media queries |
| Variable Fonts | — | N/A | Figma does not expose variable-font axes |

## 12. Known Gaps & Confidence

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

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

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

| Category | What's missing | Fallback strategy |
|----------|----------------|-------------------|
| **Hero imagery** | No dominant hero image detected above the fold | Use the canonical brand visual from §9b (OG image) for hero composition |
| **Motion / Animation** | No @keyframes or transitions detected | Either keep clones strictly static, or apply a single 150ms ease-out on hover/focus universally |
| **Component states** | Hover / focus / active states not captured | Darken background ~10% on hover, add 2px focus ring matching accent token, +50% opacity for disabled |
| **Dark mode** | No dark-mode CSS variables or media queries detected | Light mode is canonical; do not generate dark-mode variants unless explicitly requested |
| **Design tokens** | Only 0 CSS custom properties (low signal for semantic naming) | Color names are nearest-neighbor approximations; verify against brand guidelines if available |

### Per-section confidence

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

---
*Generated by Prism — automated Playwright extraction + design analysis.*
*Source: https://www.figma.com/design/n4pzjScBY5cqrPlmM9KoK2/Positivus?m=auto | 2026-06-11T05:00:49.163Z*
*Values read straight from the Figma file via the REST API (exact fills, text styles, effects, auto-layout spacing). Cross-check against the live build before shipping.*