Foundation
Stable

Design Tokens

Design tokens are the single source of truth for all visual values in Syhrezz. Every color, size, spacing, shadow, radius, and transition is defined as a CSS custom property in ds-tokens.css. Never hardcode values in components.

Import once: Add <link rel="stylesheet" href="path/to/ds-tokens.css"/> to your page head. All tokens are available globally via CSS custom properties (var(--token-name)).

Color Tokens

TokenValueUsage
--primary#3B5BDBMain brand blue — links, focus rings
--primary-light#EEF2FFTinted surfaces, badge backgrounds
--accent-director#6366F1Accent role accent color
--success#0E9F6EPositive states, icon strokes
--warning#E3A008Warnings, caution states
--danger#F05252Errors, destructive actions
--surface#F8FAFCPage background
--card#FFFFFFCard/panel background
--border#E2E8F0Default borders
--text-primary#0F172AHeadings, primary content
--text-secondary#64748BSub-labels, secondary content
--text-muted#94A3B8Placeholders, disabled, hints

Spacing Tokens

TokenValueCommon Usage
--sp-12pxTight gaps, badge padding-y
--sp-24pxNav item margin-bottom, dot indicators
--sp-48pxbtn-sm padding, badge padding, small gap
--sp-510pxNav item padding, compact card padding
--sp-612pxNav item gap, sidebar padding, button gap
--sp-816pxModal header padding-y, grid gaps
--sp-1020pxCard padding (sm), stat card padding
--sp-1224pxCard padding (default), modal body, logo area
--sp-1428pxPage header margin-bottom
--sp-1632pxHero banner padding-x, main content padding

Border Radius Tokens

TokenValueUsage
--r-xs6pxTiny elements, nav active bar
--r-sm8pxbtn-sm, small inputs, dropdown items
--r-md10pxNav items, inputs, buttons (Dark), dropdowns
--r-lg12pxNav items (Accent), logo icon, modals
--r-xl14pxStat cards, table containers
--r-2xl16pxModals, sales cards, KPI cards
--r-3xl18pxHero banner
--r-4xl20pxStandard cards (default)
--r-full999pxBadges, pills, avatars, nav-badge

Shadow Tokens

TokenValueUsage
--shadow-xs0 1px 3px rgba(0,0,0,0.06)Subtle lift, table wrap
--shadow-sm0 4px 6px rgba(0,0,0,0.02)Card default state
--shadow-md0 4px 16px rgba(37,99,235,0.06)Sales/manager cards
--shadow-lg0 12px 30px rgba(0,0,0,0.06)Card hover state
--shadow-xl0 12px 40px rgba(67,56,202,0.35)Hero banner, director cards
--shadow-btn-primary0 4px 14px rgba(99,102,241,0.3)Primary button default
--shadow-btn-hover0 6px 20px rgba(99,102,241,0.4)Primary button hover
--shadow-modal0 20px 60px rgba(0,0,0,0.2)Modal dialog
--shadow-toast0 8px 24px rgba(0,0,0,0.1)Toast notifications
--shadow-sidebar10px 0 30px rgba(0,0,0,0.1)Sidebar right edge

Motion Tokens

TokenValueUsage
--transition-fastall 0.15s easeRow hover, feed item, tooltip
--transition-baseall 0.2s easeButtons, badges, nav items (Dark)
--transition-smoothall 0.2s cubic-bezier(0.4,0,0.2,1)Nav items (Accent), card hover, button hover
--transition-sidebarall 0.35s cubic-bezier(0.4,0,0.2,1)Sidebar collapse/expand

Z-Index Tokens

TokenValueElement
--z-topbar100Top navigation bar
--z-sidebar1000Fixed sidebar
--z-modal200Modal overlay
--z-dropdown300Dropdown menus
--z-tooltip400Tooltips
--z-toast9999Toast notifications (always on top)

Complete Token File

All tokens are defined in shared/ds-tokens.css. Import this file before any component styles.

/* In your HTML head */
<link rel="stylesheet" href="path/to/ds-tokens.css"/>

/* In your CSS — use tokens everywhere */
.my-component {
  background: var(--card);
  border: 1px solid var(--border);
  border-radius: var(--r-4xl);
  padding: var(--sp-12);
  box-shadow: var(--shadow-sm);
  transition: var(--transition-smooth);
  font-family: var(--font-primary);
  color: var(--text-primary);
}