Xavier Design System
Official design system for Xavier — the corporate operations and internal management platform by RankMyApp. Tokens, components, patterns, and governance rules.
Color Tokens
38+ CSS custom properties for Xavier operations dashboards, workflow management, team governance, and product UI.
Accents
Content
Interactive
Background
Support
Sentiment / Feedback
Chart Palette
Typography
Inter for product UI. Display styles for executive dashboards and operational reports.
Display Styles
Product Styles (Inter)
Spacing Scale
18 base values from 4px to 128px. 8px grid base.
Padding Tokens
Radius Tokens
Adaptive per platform. Mobile radius values must be applied via breakpoint.
Desktop
Mobile
Buttons
Primary uses --xv-interactive-accent bg + --xv-interactive-control text. Height: 48px (large). Focus: 2px outline, 2px offset.
Priorities
Sizes
States
Focus Ring Spec
Inputs
Border: --xv-interactive-secondary. Focus: 3px solid --xv-interactive-primary. Error: --xv-sentiment-negative. Use label + description, never placeholder alone.
Metric Input
Search Input
Cards
Small (88-300px), Large (300px+). Uses radius-medium and official spacing.
List Items
7 variants documented. Navigation, Switch, Checkbox, Radio, No Action.
Navigation
Switch
Checkbox
Radio
No Action
Feedback Components
Action prompts, snackbars, progress, spinners, and state screens.
Action Prompts
Snackbar
Progress
Spinner
State Screens
Overlays
Modal desktop: 540px width, max-height 800px, 80px safe zone. Bottom sheet: mobile full width.
Modal
Confirm team restructuring
Bottom Sheet
Popover
Badges xavier_extension
Status indicators, counts, and labels. Used for team states, approval statuses, and operational health.
Variants
Sizes
With Count
Xavier Usage
Approval status: approved (green), pending (indigo), rejected (red), review (yellow)
Departments: Engineering (indigo), Product (volt), Operations (violet), Finance (cyan)
Avatar xavier_extension
User and entity representation. Used for team members, managers, and department branding.
Variants
Sizes
Group
Tooltip xavier_extension
Contextual help on hover or focus. Used for metric explanations, truncated text, and icon-only buttons.
Placements
Tokens
color: var(--xv-interactive-contrast) → #FFFFFF
border-radius: 6px
padding: 6px 12px
font-size: 12px
max-width: 280px
z-index: 1000
Table xavier_extension
Data tables for team lists, approval workflows, budget tracking, and audit logs.
Default Table
| Team | Department | Members | Health | Status |
|---|---|---|---|---|
| Core Platform | Engineering | 12 | Strong | Active |
| Growth Squad | Product | 8 | Watch | Active |
| Finance Ops | Finance | 6 | Poor | Paused |
Breadcrumb xavier_extension
Hierarchical navigation path. Used in team detail, department settings, and approval workflows.
Pagination xavier_extension
Navigate through large data sets. Used in team rosters, approval logs, and audit trails.
Skeleton xavier_extension
Loading placeholders. Used while fetching team data, approval queues, and operational metrics.
Card Skeleton
Text Skeleton
Empty State xavier_extension
Shown when no data exists. Every data-driven screen must have an empty state.
Alert / Banner xavier_extension
Contextual messages at page or section level. Used for system notices, data freshness, and action results.
Dropdown Menu xavier_extension
Contextual menu triggered by button click. Used for bulk actions, export options, and settings menus.
Dialog xavier_extension
Confirmation dialogs for destructive actions. Requires explicit user decision before proceeding.
Archive Department?
Accordion xavier_extension
Collapsible content sections. Used for FAQ, department details, and metric breakdowns.
Divider xavier_extension
Visual separator between content sections.
Variants
Metric Card xavier_extension
KPI display card for dashboards. Shows value, trend, and optional sparkline.
Product Patterns
Common product flow patterns using Xavier components and tokens.
Dashboard Layout xavier_extension
Standard layout pattern for data-heavy pages in Xavier.
Structure
(Table / Grid / Charts)
(Details / Actions)
Form Layout xavier_extension
Standard form patterns for settings, onboarding, and configuration pages.
Rules
Section spacing: var(--space-32) between groups
Field spacing: var(--space-16) between fields
Labels: Always above input, never floating
Errors: Inline below field, use --xv-sentiment-negative
Submit: Full-width primary button at bottom
Filter Pattern xavier_extension
Data filtering for team lists, approval queues, and operational reports.
Loading Strategy xavier_extension
Progressive data loading patterns used across the platform.
Strategy
2. KPIs second: Load summary metrics (fast endpoint)
3. Main data third: Load table/grid data (may be slower)
4. Charts last: Load visualization data progressively
5. Error recovery: Retry button per section, never full-page error
Dark Mode Preview
All components using dark mode token values.
Components in Dark Mode
AI Agent Rules
Non-negotiable rules for any AI agent generating UI for Xavier.
Mandatory Output Format (JSON)
Component Selection Logic
| Need | Use | Never Use |
|---|---|---|
| Primary action | Button Primary | Link styled as button |
| Cancel/dismiss | Button Secondary or Tertiary | Red button (unless destructive) |
| Destructive action | Button Negative | Primary button |
| Navigate | List Item Navigation | Custom link row |
| Toggle setting | List Item Switch | Checkbox for on/off |
| Brief feedback | Snackbar | Alert/Modal |
| Blocking prompt | Action Prompt or Modal | Snackbar |
| Budget/metric entry | Metric Input | Plain text input |
Benchmark & Gap Analysis
Component coverage compared to enterprise design systems. Updated 2026-06-04.
Our Coverage Summary
| Category | Total Components | Coverage |
|---|---|---|
| Foundations (Color, Typography, Spacing, Radius) | 4 | Complete |
| Form Controls (Button, Input, Checkbox, Radio, Switch, Select) | 6 | Complete |
| Data Display (Card, Table, Badge, Avatar, Metric Card) | 5 | Complete |
| Feedback (Alert, Snackbar, Progress, Spinner, Empty State, Skeleton) | 6 | Complete |
| Overlay (Modal, Dialog, Bottom Sheet, Popover, Tooltip, Dropdown) | 6 | Complete |
| Navigation (Tabs, Chips, Segmented Control, Breadcrumb, Pagination) | 5 | Complete |
| Layout (Accordion, Divider, Dashboard Layout) | 3 | Complete |
| Patterns (7 product patterns + 4 layout patterns) | 11 | Complete |
Backlog (P2/P3)
| Component | Priority | Reason |
|---|---|---|
| Slider / Range | P2 | Budget sliders and capacity planning |
| Date Picker | P2 | Period selection in reports |
| Tag / Tag Group | P2 | Team labels and department tags |
| ComboBox | P2 | Team member search with autocomplete |
| Toast | P2 | Non-blocking success/error notifications |
Pending Items
Items requiring validation, export, or access before full completion.
| Item | Impact | Priority | How to Resolve |
|---|---|---|---|
| Motion timing values [NEEDS_VALIDATION] | No ms durations or cubic-bezier curves confirmed | P1 | Export from Figma motion specs |
| Elevation / shadow tokens [NEEDS_VALIDATION] | Box-shadow values are estimated | P1 | Export from Figma or inspect production |
| HR Integration specs | Exact API contract for team data sync | P0 | Request integration documentation |
| Illustration guidelines | Brand illustrations for empty states | P1 | Request access from Brand team |
| Custom display font [NEEDS_VALIDATION] | Display typography uses Inter as default | P3 | Evaluate custom brand font if needed |
Xavier Design System — v1.0 — Updated 2026-06-04
Product: Xavier by RankMyApp · 38+ color tokens · 14 typography styles · 18 spacing values · 5 radius tiers · 46+ component previews
Score: 90/100 · Ready to share: Yes · Dark mode: Supported · WCAG: AA target