# BuyerKiosk Brand Style Guide

A comprehensive design system for consistent UI across the BuyerKiosk platform.

---

## Table of Contents

1. [Color System](#color-system)
2. [Typography](#typography)
3. [Spacing](#spacing)
4. [Border Radius](#border-radius)
5. [Shadows](#shadows)
6. [Buttons](#buttons)
7. [Form Elements](#form-elements)
8. [Cards](#cards)
9. [Badges & Labels](#badges--labels)
10. [Icons](#icons)
11. [Animations](#animations)
12. [Layout & Grid](#layout--grid)
13. [Responsive Breakpoints](#responsive-breakpoints)
14. [CSS Variables Reference](#css-variables-reference)

---

## Color System

### Primary Colors (Purple/Indigo)

Our primary palette anchors the brand identity. Use for CTAs, links, and key UI elements.

| Name | Hex | CSS Variable | Usage |
|------|-----|--------------|-------|
| Primary 50 | `#f5f3ff` | `--primary-50` | Light backgrounds, hover states |
| Primary 100 | `#ede9fe` | `--primary-100` | Card backgrounds, subtle highlights |
| Primary 200 | `#ddd6fe` | `--primary-200` | Borders, dividers |
| Primary 300 | `#c4b5fd` | `--primary-300` | Disabled states, muted elements |
| Primary 400 | `#a78bfa` | `--primary-400` | Secondary buttons, links |
| Primary 500 | `#8b5cf6` | `--primary-500` | — |
| **Primary 600** | `#7c3aed` | `--primary-600` | **Main accent color** |
| Primary 700 | `#6d28d9` | `--primary-700` | Hover states, active elements |
| Primary 800 | `#5b21b6` | `--primary-800` | Dark accents |
| Primary 900 | `#4c1d95` | `--primary-900` | Very dark accents |

**Gradient (Hero/CTAs):**
```css
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
```

### Secondary Colors (Teal)

Complements purple. Use for variety, secondary actions, and success-adjacent states.

| Name | Hex | CSS Variable | Usage |
|------|-----|--------------|-------|
| Secondary 50 | `#f0fdfa` | `--secondary-50` | Light backgrounds |
| Secondary 100 | `#ccfbf1` | `--secondary-100` | Subtle highlights |
| Secondary 200 | `#99f6e4` | `--secondary-200` | Borders |
| Secondary 300 | `#5eead4` | `--secondary-300` | Icons, badges |
| Secondary 400 | `#2dd4bf` | `--secondary-400` | Secondary CTAs |
| **Secondary 500** | `#14b8a6` | `--secondary-500` | **Main secondary** |
| Secondary 600 | `#0d9488` | `--secondary-600` | Hover states |
| Secondary 700 | `#0f766e` | `--secondary-700` | Dark accents |

### Semantic Colors

#### Success (Green)
| Name | Hex | Usage |
|------|-----|-------|
| Green 50 | `#f0fdf4` | Success backgrounds |
| Green 100 | `#dcfce7` | Light success |
| Green 400 | `#4ade80` | Success highlights |
| **Green 500** | `#22c55e` | **Success states** |
| Green 600 | `#16a34a` | Success hover |
| Green 700 | `#15803d` | Dark success |

#### Warning (Amber)
| Name | Hex | Usage |
|------|-----|-------|
| Amber 50 | `#fffbeb` | Warning backgrounds |
| Amber 100 | `#fef3c7` | Light warning |
| Amber 400 | `#fbbf24` | Warning highlights |
| **Amber 500** | `#f59e0b` | **Warnings, promotions** |
| Amber 600 | `#d97706` | Warning hover |
| Amber 700 | `#b45309` | Dark warning |

#### Error (Rose)
| Name | Hex | Usage |
|------|-----|-------|
| Rose 50 | `#fff1f2` | Error backgrounds |
| Rose 100 | `#ffe4e6` | Light error |
| Rose 400 | `#fb7185` | Soft alerts |
| **Rose 500** | `#f43f5e` | **Errors, destructive** |
| Rose 600 | `#e11d48` | Error hover |
| Rose 700 | `#be123c` | Dark error |

#### Info (Blue)
| Name | Hex | Usage |
|------|-----|-------|
| Blue 50 | `#eff6ff` | Info backgrounds |
| Blue 100 | `#dbeafe` | Light info |
| Blue 400 | `#60a5fa` | Info highlights |
| **Blue 500** | `#3b82f6` | **Info states** |
| Blue 600 | `#2563eb` | Info hover |
| Blue 700 | `#1d4ed8` | Dark info |

### Neutral Colors

| Name | Hex | CSS Variable | Usage |
|------|-----|--------------|-------|
| Neutral 50 | `#f8fafc` | `--dark-100` | Page backgrounds |
| Neutral 100 | `#f1f5f9` | `--dark-200` | Card backgrounds |
| Neutral 200 | `#e2e8f0` | `--dark-300` | Borders, dividers |
| Neutral 300 | `#cbd5e1` | `--dark-400` | Disabled text, placeholders |
| Neutral 400 | `#94a3b8` | `--dark-500` | Muted text |
| Neutral 500 | `#64748b` | `--dark-600` | Secondary text |
| Neutral 600 | `#475569` | `--dark-700` | Body text |
| Neutral 700 | `#334155` | `--dark-800` | Headings |
| Neutral 800 | `#1e293b` | `--dark-800` | Dark backgrounds |
| **Neutral 900** | `#0f172a` | `--dark-900` | **Darkest backgrounds** |

### Color Usage Quick Reference

| Purpose | Color | Hex |
|---------|-------|-----|
| Primary CTA | Primary 600 | `#7c3aed` |
| Primary CTA hover | Primary 700 | `#6d28d9` |
| Secondary CTA | Secondary 500 | `#14b8a6` |
| Links | Primary 600 | `#7c3aed` |
| Link hover | Primary 700 | `#6d28d9` |
| Success | Green 500 | `#22c55e` |
| Warning | Amber 500 | `#f59e0b` |
| Error | Rose 500 | `#f43f5e` |
| Info | Blue 500 | `#3b82f6` |
| Page background | Neutral 50 | `#f8fafc` |
| Card background | White | `#ffffff` |
| Body text | Neutral 600 | `#475569` |
| Headings | Neutral 900 | `#0f172a` |
| Muted text | Neutral 500 | `#64748b` |
| Borders | Neutral 200 | `#e2e8f0` |
| Dark header/footer | Neutral 900 | `#0f172a` |

---

## Typography

### Font Family

```css
font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
```

**Google Fonts Import:**
```html
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
```

### Font Sizes

| Name | Size | CSS Variable | Usage |
|------|------|--------------|-------|
| XS | 0.75rem (12px) | `--font-size-xs` | Captions, labels |
| SM | 0.875rem (14px) | `--font-size-sm` | Small text, badges |
| Base | 1rem (16px) | `--font-size-base` | Body text |
| LG | 1.125rem (18px) | `--font-size-lg` | Large body, subtitles |
| XL | 1.25rem (20px) | `--font-size-xl` | Small headings |
| 2XL | 1.5rem (24px) | `--font-size-2xl` | H4 |
| 3XL | 1.875rem (30px) | `--font-size-3xl` | H3 |
| 4XL | 2.25rem (36px) | `--font-size-4xl` | H2 |
| 5XL | 3rem (48px) | `--font-size-5xl` | H1 |
| 6XL | 3.75rem (60px) | `--font-size-6xl` | Display |

### Font Weights

| Weight | Value | Usage |
|--------|-------|-------|
| Regular | 400 | Body text |
| Medium | 500 | Emphasized text, nav links |
| Semibold | 600 | Buttons, labels |
| Bold | 700 | Headings |
| Extra Bold | 800 | Hero titles |

### Line Heights

| Usage | Line Height |
|-------|-------------|
| Headings | 1.2 |
| Body text | 1.6 |
| Relaxed (paragraphs) | 1.7 |

### Heading Styles

```css
/* H1 - Hero/Page titles */
font-size: clamp(2.25rem, 4vw, 3rem);
font-weight: 800;
line-height: 1.2;
color: #0f172a;

/* H2 - Section titles */
font-size: clamp(2rem, 4vw, 2.75rem);
font-weight: 700;
line-height: 1.2;
color: #0f172a;

/* H3 - Subsection titles */
font-size: 1.875rem;
font-weight: 700;
line-height: 1.2;
color: #0f172a;

/* H4 - Card titles */
font-size: 1.25rem;
font-weight: 600;
line-height: 1.3;
color: #0f172a;
```

---

## Spacing

Use consistent spacing throughout the UI.

| Name | Size | CSS Variable |
|------|------|--------------|
| 1 | 0.25rem (4px) | `--space-1` |
| 2 | 0.5rem (8px) | `--space-2` |
| 3 | 0.75rem (12px) | `--space-3` |
| 4 | 1rem (16px) | `--space-4` |
| 5 | 1.25rem (20px) | `--space-5` |
| 6 | 1.5rem (24px) | `--space-6` |
| 8 | 2rem (32px) | `--space-8` |
| 10 | 2.5rem (40px) | `--space-10` |
| 12 | 3rem (48px) | `--space-12` |
| 16 | 4rem (64px) | `--space-16` |
| 20 | 5rem (80px) | `--space-20` |
| 24 | 6rem (96px) | `--space-24` |

### Spacing Guidelines

- **Element padding:** `--space-4` to `--space-6`
- **Card padding:** `--space-6` to `--space-8`
- **Section padding:** `--space-16` to `--space-24`
- **Gap between items:** `--space-3` to `--space-4`
- **Gap between sections:** `--space-8` to `--space-12`

---

## Border Radius

| Name | Size | CSS Variable | Usage |
|------|------|--------------|-------|
| SM | 0.25rem (4px) | `--radius-sm` | Small elements, inputs |
| MD | 0.375rem (6px) | `--radius-md` | Default |
| LG | 0.5rem (8px) | `--radius-lg` | Buttons |
| XL | 0.75rem (12px) | `--radius-xl` | Cards, modals |
| 2XL | 1rem (16px) | `--radius-2xl` | Large cards |
| 3XL | 1.5rem (24px) | `--radius-3xl` | Hero elements |
| Full | 9999px | `--radius-full` | Pills, avatars |

---

## Shadows

| Name | Value | CSS Variable | Usage |
|------|-------|--------------|-------|
| SM | `0 1px 2px 0 rgba(0,0,0,0.05)` | `--shadow-sm` | Subtle lift |
| MD | `0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -1px rgba(0,0,0,0.06)` | `--shadow-md` | Cards |
| LG | `0 10px 15px -3px rgba(0,0,0,0.1), 0 4px 6px -2px rgba(0,0,0,0.05)` | `--shadow-lg` | Elevated cards, dropdowns |
| XL | `0 20px 25px -5px rgba(0,0,0,0.1), 0 10px 10px -5px rgba(0,0,0,0.04)` | `--shadow-xl` | Modals |
| 2XL | `0 25px 50px -12px rgba(0,0,0,0.25)` | `--shadow-2xl` | Hero elements |

### Colored Shadows (for buttons)

```css
/* Primary button shadow */
box-shadow: 0 4px 14px 0 rgba(102, 126, 234, 0.4);

/* Primary button hover */
box-shadow: 0 6px 20px 0 rgba(102, 126, 234, 0.5);

/* Purple accent shadow */
box-shadow: 0 4px 12px rgba(124, 58, 237, 0.25);

/* Blue accent shadow */
box-shadow: 0 4px 12px rgba(59, 130, 246, 0.25);

/* Green accent shadow */
box-shadow: 0 4px 12px rgba(16, 185, 129, 0.25);
```

---

## Buttons

### Primary Button

```css
.btn-primary {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    padding: 1rem 2rem;
    font-size: 1rem;
    font-weight: 600;
    color: #ffffff;
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    border: none;
    border-radius: 0.75rem;
    box-shadow: 0 4px 14px 0 rgba(102, 126, 234, 0.4);
    cursor: pointer;
    transition: all 150ms ease;
}

.btn-primary:hover {
    transform: translateY(-2px);
    box-shadow: 0 6px 20px 0 rgba(102, 126, 234, 0.5);
}
```

### Secondary Button

```css
.btn-secondary {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    padding: 1rem 2rem;
    font-size: 1rem;
    font-weight: 700;
    color: #0f172a;
    background: #ffffff;
    border: 2px solid #e2e8f0;
    border-radius: 0.75rem;
    cursor: pointer;
    transition: all 150ms ease;
}

.btn-secondary:hover {
    border-color: #7c3aed;
    color: #6d28d9;
}
```

### Ghost Button

```css
.btn-ghost {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: 0.5rem;
    padding: 1rem 2rem;
    font-size: 1rem;
    font-weight: 600;
    color: #7c3aed;
    background: transparent;
    border: none;
    border-radius: 0.75rem;
    cursor: pointer;
    transition: all 150ms ease;
}

.btn-ghost:hover {
    background: rgba(124, 58, 237, 0.1);
}
```

### Button Sizes

| Size | Padding | Font Size |
|------|---------|-----------|
| Small | `0.5rem 1rem` | `0.875rem` |
| Default | `1rem 2rem` | `1rem` |
| Large | `1.25rem 2.5rem` | `1.125rem` |

### Pill Button (Nav CTA)

```css
.btn-pill {
    padding: 0.75rem 1.5rem;
    border-radius: 9999px;
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    color: #ffffff;
    font-weight: 600;
}
```

### Destructive Button

```css
.btn-destructive {
    background: #f43f5e;
    color: #ffffff;
    box-shadow: 0 4px 14px 0 rgba(244, 63, 94, 0.4);
}

.btn-destructive:hover {
    background: #e11d48;
    box-shadow: 0 6px 20px 0 rgba(244, 63, 94, 0.5);
}
```

---

## Form Elements

### Text Input

```css
.input {
    width: 100%;
    padding: 0.75rem 1rem;
    font-size: 1rem;
    color: #0f172a;
    background: #ffffff;
    border: 1px solid #e2e8f0;
    border-radius: 0.5rem;
    transition: all 150ms ease;
}

.input:focus {
    outline: none;
    border-color: #7c3aed;
    box-shadow: 0 0 0 3px rgba(124, 58, 237, 0.1);
}

.input::placeholder {
    color: #94a3b8;
}

.input:disabled {
    background: #f1f5f9;
    color: #94a3b8;
    cursor: not-allowed;
}
```

### Input with Error

```css
.input-error {
    border-color: #f43f5e;
}

.input-error:focus {
    box-shadow: 0 0 0 3px rgba(244, 63, 94, 0.1);
}

.error-message {
    margin-top: 0.5rem;
    font-size: 0.875rem;
    color: #f43f5e;
}
```

### Select

```css
.select {
    appearance: none;
    padding: 0.75rem 2.5rem 0.75rem 1rem;
    background-image: url("data:image/svg+xml,..."); /* chevron */
    background-repeat: no-repeat;
    background-position: right 1rem center;
    background-size: 1rem;
}
```

### Checkbox & Radio

Use iCheck library with purple skin, or custom:

```css
.checkbox {
    width: 1.25rem;
    height: 1.25rem;
    accent-color: #7c3aed;
}
```

---

## Cards

### Basic Card

```css
.card {
    background: #ffffff;
    border: 1px solid #e2e8f0;
    border-radius: 1rem;
    padding: 2rem;
    box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
    transition: all 200ms ease;
}

.card:hover {
    transform: translateY(-4px);
    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
    border-color: transparent;
}
```

### Feature Card

```css
.feature-card {
    background: #ffffff;
    border: 1px solid #e2e8f0;
    border-radius: 1rem;
    padding: 2rem;
}

.feature-card__icon {
    width: 56px;
    height: 56px;
    display: flex;
    align-items: center;
    justify-content: center;
    background: linear-gradient(135deg, rgba(102, 126, 234, 0.1), rgba(118, 75, 162, 0.1));
    border-radius: 0.75rem;
    margin-bottom: 1.5rem;
    color: #667eea;
}

.feature-card__title {
    font-size: 1.25rem;
    font-weight: 600;
    color: #0f172a;
    margin-bottom: 0.75rem;
}

.feature-card__description {
    font-size: 1rem;
    color: #64748b;
    line-height: 1.6;
}
```

### Benefit Card (Colored Variants)

```css
/* Operations - Purple */
.benefit-card--operations .benefit-card__icon {
    background: linear-gradient(135deg, rgba(124, 58, 237, 0.12), rgba(124, 58, 237, 0.06));
    color: #7c3aed;
}

/* Experience - Blue */
.benefit-card--experience .benefit-card__icon {
    background: linear-gradient(135deg, rgba(59, 130, 246, 0.12), rgba(59, 130, 246, 0.06));
    color: #3b82f6;
}

/* Growth - Green */
.benefit-card--growth .benefit-card__icon {
    background: linear-gradient(135deg, rgba(16, 185, 129, 0.12), rgba(16, 185, 129, 0.06));
    color: #10b981;
}
```

---

## Badges & Labels

### Basic Badge

```css
.badge {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.25rem 0.75rem;
    font-size: 0.875rem;
    font-weight: 500;
    border-radius: 9999px;
}

/* Primary */
.badge-primary {
    background: linear-gradient(135deg, rgba(102, 126, 234, 0.1), rgba(118, 75, 162, 0.1));
    border: 1px solid rgba(102, 126, 234, 0.2);
    color: #667eea;
}

/* Success */
.badge-success {
    background: rgba(34, 197, 94, 0.1);
    color: #16a34a;
}

/* Warning */
.badge-warning {
    background: rgba(245, 158, 11, 0.1);
    color: #d97706;
}

/* Error */
.badge-error {
    background: rgba(244, 63, 94, 0.1);
    color: #e11d48;
}
```

### Section Label

```css
.section-label {
    display: inline-block;
    font-size: 0.875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: #7c3aed;
    margin-bottom: 1rem;
}
```

---

## Icons

### Icon Sizes

| Size | Dimensions |
|------|------------|
| XS | 16px |
| SM | 20px |
| MD | 24px |
| LG | 32px |
| XL | 48px |

### Icon Container

```css
.icon-container {
    width: 56px;
    height: 56px;
    display: flex;
    align-items: center;
    justify-content: center;
    background: linear-gradient(135deg, rgba(102, 126, 234, 0.1), rgba(118, 75, 162, 0.1));
    border-radius: 0.75rem;
}

.icon-container svg {
    width: 24px;
    height: 24px;
    stroke: #667eea;
    stroke-width: 2;
}
```

### Recommended Icon Libraries

- **Heroicons** (primary): https://heroicons.com
- **Font Awesome** (legacy): Already included

---

## Animations

### Transitions

```css
/* Fast - micro-interactions */
transition: all 150ms ease;

/* Base - standard interactions */
transition: all 200ms ease;

/* Slow - emphasis animations */
transition: all 300ms ease;
```

### Hover Effects

```css
/* Lift effect */
transform: translateY(-2px);

/* Card lift */
transform: translateY(-4px);

/* Scale on hover */
transform: scale(1.05);
```

### Gradient Shimmer (Hero text)

```css
@keyframes gradientShimmer {
    0% { background-position: 0% 50%; }
    100% { background-position: 200% 50%; }
}

.shimmer-text {
    background: linear-gradient(90deg, #667eea, #764ba2, #667eea);
    background-size: 200% 100%;
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
    animation: gradientShimmer 2s ease-in-out infinite;
}
```

### Fade In Slide

```css
@keyframes fadeInSlide {
    from {
        opacity: 0;
        transform: translateY(20px);
    }
    to {
        opacity: 1;
        transform: translateY(0);
    }
}
```

### Subtle Float

```css
@keyframes subtleFloat {
    0%, 100% { transform: translateY(0); }
    50% { transform: translateY(-10px); }
}
```

---

## Layout & Grid

### Container

```css
.container {
    width: 100%;
    max-width: 1280px;
    margin: 0 auto;
    padding: 0 1.5rem;
}

@media (max-width: 575px) {
    .container {
        padding: 0 1rem;
    }
}
```

### Section

```css
.section {
    padding: 5rem 0;
}

@media (max-width: 575px) {
    .section {
        padding: 3rem 0;
    }
}
```

### Grid Systems

```css
/* 2-column */
.grid-2 {
    display: grid;
    grid-template-columns: repeat(2, 1fr);
    gap: 2rem;
}

/* 3-column */
.grid-3 {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: 2rem;
}

/* 4-column */
.grid-4 {
    display: grid;
    grid-template-columns: repeat(4, 1fr);
    gap: 2rem;
}

/* Responsive */
@media (max-width: 991px) {
    .grid-3, .grid-4 {
        grid-template-columns: repeat(2, 1fr);
    }
}

@media (max-width: 575px) {
    .grid-2, .grid-3, .grid-4 {
        grid-template-columns: 1fr;
    }
}
```

---

## Responsive Breakpoints

| Name | Max Width | Target |
|------|-----------|--------|
| SM | 575px | Mobile |
| MD | 767px | Large mobile / Small tablet |
| LG | 991px | Tablet |
| XL | 1199px | Small desktop |
| 2XL | 1399px | Large desktop |

```css
/* Mobile first approach */
@media (max-width: 575px) { /* Mobile */ }
@media (max-width: 767px) { /* Large mobile */ }
@media (max-width: 991px) { /* Tablet */ }
@media (max-width: 1199px) { /* Small desktop */ }
```

---

## CSS Variables Reference

Copy this into your project's root CSS:

```css
:root {
    /* ===== COLORS ===== */

    /* Primary (Purple) */
    --primary-50: #f5f3ff;
    --primary-100: #ede9fe;
    --primary-200: #ddd6fe;
    --primary-300: #c4b5fd;
    --primary-400: #a78bfa;
    --primary-500: #8b5cf6;
    --primary-600: #7c3aed;
    --primary-700: #6d28d9;
    --primary-800: #5b21b6;
    --primary-900: #4c1d95;

    /* Primary Gradient */
    --primary-gradient-start: #667eea;
    --primary-gradient-end: #764ba2;

    /* Secondary (Teal) */
    --secondary-50: #f0fdfa;
    --secondary-100: #ccfbf1;
    --secondary-200: #99f6e4;
    --secondary-300: #5eead4;
    --secondary-400: #2dd4bf;
    --secondary-500: #14b8a6;
    --secondary-600: #0d9488;
    --secondary-700: #0f766e;

    /* Success (Green) */
    --green-50: #f0fdf4;
    --green-100: #dcfce7;
    --green-400: #4ade80;
    --green-500: #22c55e;
    --green-600: #16a34a;
    --green-700: #15803d;

    /* Warning (Amber) */
    --amber-50: #fffbeb;
    --amber-100: #fef3c7;
    --amber-400: #fbbf24;
    --amber-500: #f59e0b;
    --amber-600: #d97706;
    --amber-700: #b45309;

    /* Error (Rose) */
    --rose-50: #fff1f2;
    --rose-100: #ffe4e6;
    --rose-400: #fb7185;
    --rose-500: #f43f5e;
    --rose-600: #e11d48;
    --rose-700: #be123c;

    /* Info (Blue) */
    --blue-50: #eff6ff;
    --blue-100: #dbeafe;
    --blue-400: #60a5fa;
    --blue-500: #3b82f6;
    --blue-600: #2563eb;
    --blue-700: #1d4ed8;

    /* Neutrals */
    --neutral-50: #f8fafc;
    --neutral-100: #f1f5f9;
    --neutral-200: #e2e8f0;
    --neutral-300: #cbd5e1;
    --neutral-400: #94a3b8;
    --neutral-500: #64748b;
    --neutral-600: #475569;
    --neutral-700: #334155;
    --neutral-800: #1e293b;
    --neutral-900: #0f172a;

    /* Legacy aliases */
    --dark-100: var(--neutral-50);
    --dark-200: var(--neutral-100);
    --dark-300: var(--neutral-200);
    --dark-400: var(--neutral-300);
    --dark-500: var(--neutral-400);
    --dark-600: var(--neutral-500);
    --dark-700: var(--neutral-600);
    --dark-800: var(--neutral-700);
    --dark-900: var(--neutral-900);
    --white: #ffffff;

    /* ===== TYPOGRAPHY ===== */
    --font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --font-size-xs: 0.75rem;
    --font-size-sm: 0.875rem;
    --font-size-base: 1rem;
    --font-size-lg: 1.125rem;
    --font-size-xl: 1.25rem;
    --font-size-2xl: 1.5rem;
    --font-size-3xl: 1.875rem;
    --font-size-4xl: 2.25rem;
    --font-size-5xl: 3rem;
    --font-size-6xl: 3.75rem;

    /* ===== SPACING ===== */
    --space-1: 0.25rem;
    --space-2: 0.5rem;
    --space-3: 0.75rem;
    --space-4: 1rem;
    --space-5: 1.25rem;
    --space-6: 1.5rem;
    --space-8: 2rem;
    --space-10: 2.5rem;
    --space-12: 3rem;
    --space-16: 4rem;
    --space-20: 5rem;
    --space-24: 6rem;

    /* ===== BORDER RADIUS ===== */
    --radius-sm: 0.25rem;
    --radius-md: 0.375rem;
    --radius-lg: 0.5rem;
    --radius-xl: 0.75rem;
    --radius-2xl: 1rem;
    --radius-3xl: 1.5rem;
    --radius-full: 9999px;

    /* ===== SHADOWS ===== */
    --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
    --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
    --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);

    /* ===== TRANSITIONS ===== */
    --transition-fast: 150ms ease;
    --transition-base: 200ms ease;
    --transition-slow: 300ms ease;
}
```

---

## Logo Assets

Located at `/public_html/images/front/logos/`:

| File | Usage |
|------|-------|
| `logo_dark.png` | Light backgrounds |
| `logo_dark.svg` | Light backgrounds (vector) |
| `logo_white.png` | Dark backgrounds |
| `logo_white.svg` | Dark backgrounds (vector) |
| `logo_alt.png` | Alternative version |
| `logo_dark@0.5x.png` | Half-size for small displays |
| `logo_white@0.5x.png` | Half-size for small displays |

**Standard logo height:** 40px (nav), 180px (hero/email headers)

---

## Accessibility

- **Color contrast:** Ensure 4.5:1 ratio for body text, 3:1 for large text
- **Focus states:** Always visible, use `box-shadow: 0 0 0 3px rgba(124, 58, 237, 0.3)`
- **Touch targets:** Minimum 44x44px for interactive elements
- **Motion:** Respect `prefers-reduced-motion` media query

```css
@media (prefers-reduced-motion: reduce) {
    * {
        animation-duration: 0.01ms !important;
        transition-duration: 0.01ms !important;
    }
}
```

---

*Last updated: December 2024*