Design System Master File

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

Project: AiTori Admin Generated: 2026-03-05 01:00:32 Category: Analytics Dashboard

Global Rules

Color Palette

Role	Hex	CSS Variable
Primary	`#0EA5E9`	`--color-primary`
Secondary	`#38BDF8`	`--color-secondary`
CTA/Accent	`#F97316`	`--color-cta`
Background	`#F0F9FF`	`--color-background`
Text	`#0C4A6E`	`--color-text`

Color Notes: Sky blue trust + warm CTA

Typography

Heading Font: Fira Code
Body Font: Fira Sans
Mood: dashboard, data, analytics, code, technical, precise
Google Fonts: Fira Code + Fira Sans

CSS Import:

@import url('https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500;600;700&family=Fira+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

/* Primary Button */
.btn-primary {
  background: #F97316;
  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: #0EA5E9;
  border: 2px solid #0EA5E9;
  padding: 12px 24px;
  border-radius: 8px;
  font-weight: 600;
  transition: all 200ms ease;
  cursor: pointer;
}

Cards

.card {
  background: #F0F9FF;
  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

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

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

Modals

.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: Data-Dense Dashboard

Keywords: Multiple charts/widgets, data tables, KPI cards, minimal padding, grid layout, space-efficient, maximum data visibility

Best For: Business intelligence dashboards, financial analytics, enterprise reporting, operational dashboards, data warehousing

Key Effects: Hover tooltips, chart zoom on click, row highlighting on hover, smooth filter animations, data loading spinners

Page Pattern

Pattern Name: Scroll-Triggered Storytelling

Conversion Strategy: Narrative increases time-on-page 3x. Use progress indicator. Mobile: simplify animations.
CTA Placement: End of each chapter (mini) + Final climax CTA
Section Order: 1. Intro hook, 2. Chapter 1 (problem), 3. Chapter 2 (journey), 4. Chapter 3 (solution), 5. Climax CTA

Anti-Patterns (Do NOT Use)

❌ Ornate design
❌ No filtering

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
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

MASTER.md 5.1 KB Histórico Raw