Skip to content

Source: design-system/affiliate-review-site/MASTER.md. Edit it there; this page is generated at build time.

Design System Master File ​

LOGIC: When building a specific page, first check design-system/affiliate-review-site/pages/[page-name].md. If that file exists, its rules override this Master file. If not, strictly follow the rules below.

Note on the path above: this file is generated by an external tool (see Generated below), and the generator emits design-system/pages/[page-name].md — one level too shallow, because it does not know it is written into a per-project subfolder. The path has been corrected by hand here. If a regeneration reverts it, correct it again; pages/README.md is the authority on where overrides actually live.


Project: Affiliate Review Site Generated: 2026-09-05 22:55:23 Category: General


Global Rules ​

Color Palette ​

RoleHexCSS Variable
Primary#F59E0B--color-primary
On Primary#0F172A--color-on-primary
Secondary#FBBF24--color-secondary
On Secondary#0F172A--color-on-secondary
Accent/CTA#16A34A--color-accent
On Accent/CTA#000000--color-on-accent
Background#FFFBEB--color-background
Foreground#0F172A--color-foreground
Card#FFFFFF--color-card
Card Foreground#0F172A--color-card-foreground
Muted#FCF6F0--color-muted
Muted Foreground#475569--color-muted-foreground
Border#FAEEE1--color-border
Destructive#DC2626--color-destructive
On Destructive#FFFFFF--color-on-destructive
Ring#000000--color-ring

Color Notes: Star gold + positive green + negative red

Color Palette — Dark ​

Set by html[data-theme="dark"], or by prefers-color-scheme: dark when no data-theme has been chosen. The utilities compile to var(--color-*), so the dark theme is these variable overrides and nothing else — there are no dark: variants in the Blade apart from the two theme-toggle icons.

RoleHexCSS VariableContrast
Primary#F59E0B--color-primary8.6:1 on Background
On Primary#0F172A--color-primary-foreground8.3:1 on Primary
Secondary#FBBF24--color-secondary11.1:1 on Background
On Secondary#0F172A--color-secondary-foreground10.7:1 on Secondary
Accent/CTA#16A34A--color-accent5.1:1 on Card
On Accent/CTA#0F172A--color-accent-foreground5.4:1 on Accent
Accent as text#4ADE80--color-accent-text9.7:1 on Card
Primary as text#FBBF24--color-primary-text10.1:1 on Card
Background#16130E--color-background—
Foreground#F6F1E7--color-foreground16.5:1 on Background
Card#211C15--color-card—
Card Foreground#F6F1E7--color-card-foreground15.0:1 on Card
Muted#2A241B--color-muted—
Muted Foreground#B6AD9D--color-muted-foreground6.9:1 on Muted
Border#42392B--color-borderdecorative
Destructive#F87171--color-destructive6.1:1 on Card
On Destructive#0F172A--color-destructive-foreground6.5:1 on Destructive
Ring#F59E0B--color-ring7.9:1 on Card (needs 3:1)

Dark Color Notes: The two "as text" shades invert. On white, raw amber (2.1:1) and raw green (3.3:1) fail body-text contrast, so the light theme darkens them to #B45309 / #15803D. On a near-black ground the darkened shades are the failing ones, so dark uses the brighter amber 400 and green 400 instead. --color-ring follows the same rule — raw #F59E0B in dark, the darkened #B45309 in light. Destructive also brightens (red 600 is only 3.4:1 on the dark background) and its foreground flips from white to ink. Brand fills — Primary, Secondary, Accent — are unchanged in both themes; only their text-role counterparts move.

Theme-independent pair: --color-overlay (#FFFFFF) and --color-overlay-foreground (#0F172A) are fixed in both themes. They are for content sitting on the hero carousel's image scrim, which is dark regardless of theme — using text-foreground there would render near-white text on the white carousel buttons in dark mode.

Typography ​

  • Heading Font: Outfit
  • Body Font: Work Sans
  • Mood: geometric, modern, clean, balanced, contemporary, versatile
  • Google Fonts: Outfit + Work Sans

CSS Import:

css
@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&family=Work+Sans:wght@300;400;500;600;700&display=swap');

Spacing Variables ​

TokenValueUsage
--space-xs4px / 0.25remTight gaps
--space-sm8px / 0.5remIcon gaps, inline spacing
--space-md16px / 1remStandard padding
--space-lg24px / 1.5remSection padding
--space-xl32px / 2remLarge gaps
--space-2xl48px / 3remSection margins
--space-3xl64px / 4remHero padding

Shadow Depths ​

LevelValueUsage
--shadow-sm0 1px 2px rgba(0,0,0,0.05)Subtle lift
--shadow-md0 4px 6px rgba(0,0,0,0.1)Cards, buttons
--shadow-lg0 10px 15px rgba(0,0,0,0.1)Modals, dropdowns
--shadow-xl0 20px 25px rgba(0,0,0,0.15)Hero images, featured cards

Component Specs ​

Buttons ​

css
/* Primary Button */
.btn-primary {
  background: #16A34A;
  color: white;
  padding: 12px 24px;
  border-radius: 8px;
  font-weight: 600;
  transition: all 200ms ease;
  cursor: pointer;
}

.btn-primary:hover {
  opacity: 0.9;
  transform: translateY(-1px);
}

/* Secondary Button */
.btn-secondary {
  background: transparent;
  color: #F59E0B;
  border: 2px solid #F59E0B;
  padding: 12px 24px;
  border-radius: 8px;
  font-weight: 600;
  transition: all 200ms ease;
  cursor: pointer;
}

Cards ​

css
.card {
  background: #FFFBEB;
  border-radius: 12px;
  padding: 24px;
  box-shadow: var(--shadow-md);
  transition: all 200ms ease;
  cursor: pointer;
}

.card:hover {
  box-shadow: var(--shadow-lg);
  transform: translateY(-2px);
}

Inputs ​

css
.input {
  padding: 12px 16px;
  border: 1px solid #E2E8F0;
  border-radius: 8px;
  font-size: 16px;
  transition: border-color 200ms ease;
}

.input:focus {
  border-color: #F59E0B;
  outline: none;
  box-shadow: 0 0 0 3px #F59E0B20;
}

Modals ​

css
.modal-overlay {
  background: rgba(0, 0, 0, 0.5);
  backdrop-filter: blur(4px);
}

.modal {
  background: white;
  border-radius: 16px;
  padding: 32px;
  box-shadow: var(--shadow-xl);
  max-width: 500px;
  width: 90%;
}

Style Guidelines ​

Style: Minimalism & Swiss Style

Keywords: Clean, simple, spacious, functional, white space, high contrast, geometric, sans-serif, grid-based, essential

Best For: Enterprise apps, dashboards, documentation sites, SaaS platforms, professional tools

Key Effects: Subtle hover (200-250ms), smooth transitions, sharp shadows if any, clear type hierarchy, fast loading

Page Pattern ​

Pattern Name: Hero + Features + CTA

  • Conversion Strategy: Deep CTA placement. For CTA label text, verify at least 4.5:1 against the button fill; use 7:1 only when the product explicitly targets AAA normal-text contrast. Keep focus and component boundaries independently visible. Disable hero parallax under reduced motion and render its static final state.
  • CTA Placement: Hero (sticky) + Bottom
  • Section Order: Hero with headline/image > Value prop > Key features (3-5) > CTA section > Footer

Anti-Patterns (Do NOT Use) ​

Additional Forbidden Patterns ​

  • ❌ Emojis as icons — Use SVG icons (Heroicons, Lucide, Simple Icons)
  • ❌ Missing cursor:pointer — All clickable elements must have cursor:pointer
  • ❌ Layout-shifting hovers — Avoid scale transforms that shift layout
  • ❌ Low contrast text — Maintain 4.5:1 minimum contrast ratio
  • ❌ Instant state changes — Always use transitions (150-300ms)
  • ❌ Invisible focus states — Focus states must be visible for a11y

Pre-Delivery Checklist ​

Before delivering any UI code, verify:

  • [ ] No emojis used as icons (use SVG instead)
  • [ ] All icons from consistent icon set (Heroicons/Lucide)
  • [ ] cursor-pointer on all clickable elements
  • [ ] Hover states with smooth transitions (150-300ms)
  • [ ] Light mode: text contrast 4.5:1 minimum
  • [ ] Dark mode: text contrast 4.5:1 minimum (check both data-theme="dark" and a dark OS with no data-theme)
  • [ ] New colors added as --color-* tokens with a dark counterpart — never a raw hex or a dark: variant in Blade
  • [ ] Focus states visible for keyboard navigation
  • [ ] prefers-reduced-motion respected
  • [ ] Responsive: 375px, 768px, 1024px, 1440px
  • [ ] No content hidden behind fixed navbars
  • [ ] No horizontal scroll on mobile