DESIGN.md · Analysis

ScaleYourShop

scaleyourshop.app · 21 Jun 2026 · 47 colors · Geist, Arial, sans-serif

ScaleYourShop

A B2B SaaS platform for WooCommerce merchants to duplicate and localize product catalogs across 22 European markets with AI-powered native rewriting and anti-footprint optimization.

Colors

surface#ffffff
surface-dim#f9f9f9
surface-bright#ffffff
surface-container-lowest#f5f5f5
surface-container-low#f0f0f0
surface-container#eeeeee
surface-container-high#e5e5e5
surface-container-highest#dddddd
on-surface#1a1a1a
on-surface-variant#666666
inverse-surface#0a0a0a
inverse-on-surface#ededed
outline#cccccc
outline-variant#bbbbbb
surface-tint#1a1a1a
primary#1a1a1a
on-primary#ffffff
primary-container#333333
on-primary-container#f0f0f0
inverse-primary#ededed
secondary#444444
on-secondary#ffffff
secondary-container#707070
on-secondary-container#f9f9f9
tertiary#888888
on-tertiary#ffffff
tertiary-container#999999
on-tertiary-container#f5f5f5
error#d32f2f
on-error#ffffff
error-container#ffcdd2
on-error-container#b71c1c
primary-fixed#333333
primary-fixed-dim#1a1a1a
on-primary-fixed#ffffff
on-primary-fixed-variant#f0f0f0
secondary-fixed#707070
secondary-fixed-dim#444444
on-secondary-fixed#ffffff
on-secondary-fixed-variant#f9f9f9
tertiary-fixed#999999
tertiary-fixed-dim#888888
on-tertiary-fixed#ffffff
on-tertiary-fixed-variant#f5f5f5
background#ffffff
on-background#1a1a1a
surface-variant#e0e0e0

Typography

display
fontFamily: Geist, Arial, sans-serif · fontSize: 57.6px · fontWeight: 900 · lineHeight: 64px · letterSpacing: -0.02em
headline-lg
fontFamily: Geist, Arial, sans-serif · fontSize: 48px · fontWeight: 900 · lineHeight: 56px · letterSpacing: -0.015em
headline-md
fontFamily: Geist, Arial, sans-serif · fontSize: 28px · fontWeight: 800 · lineHeight: 36px · letterSpacing: -0.01em
title-lg
fontFamily: Geist, Arial, sans-serif · fontSize: 20px · fontWeight: 700 · lineHeight: 28px · letterSpacing: -0.005em
body-lg
fontFamily: Geist, Arial, sans-serif · fontSize: 17px · fontWeight: 400 · lineHeight: 28px · letterSpacing: 0em
body-md
fontFamily: Geist, Arial, sans-serif · fontSize: 16px · fontWeight: 400 · lineHeight: 24px · letterSpacing: 0em
label-md
fontFamily: Geist, Arial, sans-serif · fontSize: 15px · fontWeight: 600 · lineHeight: 20px · letterSpacing: 0.01em
label-sm
fontFamily: Geist, Arial, sans-serif · fontSize: 12px · fontWeight: 700 · lineHeight: 16px · letterSpacing: 0.08em

Design guidance

Overview

ScaleYourShop is a B2B SaaS platform that enables WooCommerce merchants to rapidly duplicate and localize product catalogs across 22 European markets. The brand embodies "Efficient Minimalism"—a design philosophy that prioritizes clarity, speed, and functional elegance over ornamentation. The interface conveys confidence through a high-contrast monochromatic palette (pure black #1a1a1a on white #ffffff) paired with generous whitespace and precise typography, creating an atmosphere of professional control and technical sophistication. Users interact with a system that feels both powerful and approachable, where every pixel serves a purpose and every interaction is instantaneous.

The brand voice is direct, pragmatic, and solution-oriented. ScaleYourShop speaks to independent e-commerce operators and small-to-medium enterprises with language that is concrete, jargon-light, and action-focused. The tone avoids hype; instead, it emphasizes measurable outcomes and technical precision. Example sentence in brand voice: "Connect once, deploy everywhere—Claude handles the rewriting, we handle the complexity."

Colors

The color system is rooted in a high-contrast, achromatic foundation that communicates trust and technical competence. Primary (#1a1a1a, a near-black) is deployed on all call-to-action buttons, navigation elements, and interactive states—it is the signature accent that drives user attention and action. On-primary (#ffffff) ensures maximum legibility and accessibility on dark backgrounds. The surface stack progresses from pure white (#ffffff) at the brightest level through carefully calibrated grays (surface-container-low #f0f0f0, surface-container-high #e5e5e5) to create visual hierarchy without introducing color. Secondary (#444444) and tertiary (#888888) are reserved for supporting UI elements, disabled states, and secondary labels, maintaining the monochromatic aesthetic while providing

Typography

The typography system is built on Geist, a geometric sans-serif optimized for screen legibility and technical content, with Arial as a fallback. Display (57.6px, weight 900, line-height 64px, letter-spacing -0.02em) is reserved for hero headlines and primary page titles, commanding attention through scale and weight. Headline-lg (48px, weight 900) and headline-md (28px, weight 800) create a two-tier hierarchy for section headers, with aggressive negative letter-spacing (-0.015em, -0.01em respectively) that tightens the letterforms and conveys density and purpose. Body-lg (17px, weight 400, line-height 28px) and body-md (16px, weight 400, line-height 24px) provide comfortable reading rhythm for descriptive copy and feature explanations. Label-md (15px, weight 600) and label-sm (12px, weight

Layout

The layout system employs a 12-column grid with a fixed container max-width of 1200px, centered with symmetric padding of 40px (lg spacing) on desktop. The hero section uses a two-column grid (1fr 1fr) with 80px gap, creating a balanced composition that pairs narrative copy with an interactive demo card. Section spacing follows a semantic rhythm: lg spacing (40px) separates major sections, md spacing (24px) divides subsections, and sm spacing (12px) groups related elements. The page maintains a single-column layout on mobile (< 768px) with reduced padding (24px gutter) and stacked components. Whitespace is treated as a first-class design element—negative space around cards, buttons, and text blocks creates visual breathing room and reduces cognitive load. The container-max-width of 1200px

Elevation & Depth

Depth in ScaleYourShop is conveyed through subtle shadow layering rather than color or blur. The elevation system defines three levels: Level 1 (Base, no shadow) for the page background and default card states; Level 2 (Standard, box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08)) for cards, modals, and elevated containers; Level 3 (Prominent, box-shadow: 0 8px 40px rgba(0, 0, 0, 0.08)) for hero cards, floating panels, and interactive overlays. Shadows use a soft, spread blur (12px to 40px) with low opacity (0.06 to 0.08) to create a diffuse, naturalistic effect rather than a hard drop. Interactive el

Shapes

The shape system follows a philosophy of "Functional Softness"—rounded corners are applied strategically to reduce visual harshness while maintaining a technical, professional aesthetic. Buttons and primary CTAs use rounded: full (999px border-radius) to create a pill shape that feels approachable and clickable, with padding 14px 32px and height 48px for comfortable touch targets. Cards and containers use rounded: lg (16px) to soften edges without appearing playful or casual. Input fields and smaller interactive elements use rounded: DEFAULT (8px) for a subtle curve that signals interactivity

Components

Action Elements Buttons are the primary interaction mechanism and use a consistent 48px height with 14px vertical padding and 32px horizontal padding for comfortable touch targets. The primary button (button-primary) uses background #1a1a1a, color #ffffff, font-weight 700, border-radius 999px, and applies a transition: all 250ms ease. On hover, the background shifts to primary-container (#333333) and text to on-primary-container (#f0f0f0), creating a subtle darkening effect. The secondary button (button-secondary) uses a 2px solid border in outline color (#cccccc), transparent background, and primary text color (#1a1a1a). On hover, the background becomes surface-container-high (#e5e5e5) and the border shifts to primary (#1a1a1a), signaling activation. Both buttons use label-md typograp

Do's and Don'ts

**Do**

  • Do use primary (#1a1a1a) exclusively for CTAs, active states, and primary navigation—it is the signature accent that drives user action.
  • Do maintain high contrast between text and background (minimum 7:1 ratio per WCAG AA) to ensure legibility across all surfaces.
  • Do apply box-shadow: 0 8px 40px rgba(0, 0, 0, 0.08) consistently across elevated components to create a unified depth language.
  • Do use negative letter-spacing (-0.02em to -0.01em) on all headlines to create visual tension and forward momentum.
  • Do apply transition: all 250ms ease on interactive elements to provide smooth, predictable feedback.
  • Do use rounded full (999px) exclusively for buttons and badges to create a clear visual distinction from other components.

**Don't**

  • Don't introduce color beyond the monochromatic palette and error red (#d32f2f)—the system's power lies in its achromatic restraint.
  • Don't use box-shadow values larger than 0 8px 40px rgba(0, 0, 0, 0.08) or with opacity greater than 0.12, as this breaks the subtle elevation hierarchy.
  • Don't apply rounded corners smaller than 4px (sm) or larger than 20px (xl) outside of the full (999px) button pill—intermediate values create visual confusion.
  • Don't mix font families—Geist is the sole typeface; Arial is fallback only. Never introduce system fonts or serif families.
  • Don't use letter-spacing greater than 0.08em on body copy, as this reduces readability; reserve tight letter-spacing (-0.02em) for headlines only.
  • Don't apply opacity or transparency to text colors—use the discrete on-surface and on-surface-variant tokens instead for consistent contrast.