Appearance
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.mdis the authority on where overrides actually live.
Project: Affiliate Review Site Generated: 2026-09-05 22:55:23 Category: General
Global Rules
Color Palette
| Role | Hex | CSS 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.
| Role | Hex | CSS Variable | Contrast |
|---|---|---|---|
| Primary | #F59E0B | --color-primary | 8.6:1 on Background |
| On Primary | #0F172A | --color-primary-foreground | 8.3:1 on Primary |
| Secondary | #FBBF24 | --color-secondary | 11.1:1 on Background |
| On Secondary | #0F172A | --color-secondary-foreground | 10.7:1 on Secondary |
| Accent/CTA | #16A34A | --color-accent | 5.1:1 on Card |
| On Accent/CTA | #0F172A | --color-accent-foreground | 5.4:1 on Accent |
| Accent as text | #4ADE80 | --color-accent-text | 9.7:1 on Card |
| Primary as text | #FBBF24 | --color-primary-text | 10.1:1 on Card |
| Background | #16130E | --color-background | — |
| Foreground | #F6F1E7 | --color-foreground | 16.5:1 on Background |
| Card | #211C15 | --color-card | — |
| Card Foreground | #F6F1E7 | --color-card-foreground | 15.0:1 on Card |
| Muted | #2A241B | --color-muted | — |
| Muted Foreground | #B6AD9D | --color-muted-foreground | 6.9:1 on Muted |
| Border | #42392B | --color-border | decorative |
| Destructive | #F87171 | --color-destructive | 6.1:1 on Card |
| On Destructive | #0F172A | --color-destructive-foreground | 6.5:1 on Destructive |
| Ring | #F59E0B | --color-ring | 7.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
| Token | Value | Usage |
|---|---|---|
--space-xs | 4px / 0.25rem | Tight gaps |
--space-sm | 8px / 0.5rem | Icon gaps, inline spacing |
--space-md | 16px / 1rem | Standard padding |
--space-lg | 24px / 1.5rem | Section padding |
--space-xl | 32px / 2rem | Large gaps |
--space-2xl | 48px / 3rem | Section margins |
--space-3xl | 64px / 4rem | Hero padding |
Shadow Depths
| Level | Value | Usage |
|---|---|---|
--shadow-sm | 0 1px 2px rgba(0,0,0,0.05) | Subtle lift |
--shadow-md | 0 4px 6px rgba(0,0,0,0.1) | Cards, buttons |
--shadow-lg | 0 10px 15px rgba(0,0,0,0.1) | Modals, dropdowns |
--shadow-xl | 0 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-pointeron 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 nodata-theme) - [ ] New colors added as
--color-*tokens with a dark counterpart — never a raw hex or adark:variant in Blade - [ ] Focus states visible for keyboard navigation
- [ ]
prefers-reduced-motionrespected - [ ] Responsive: 375px, 768px, 1024px, 1440px
- [ ] No content hidden behind fixed navbars
- [ ] No horizontal scroll on mobile