Color Palette
The Really Global brand colors and semantic design tokens.
Brand Colors
Primary Teal
--primary
Navy
--foreground
Coral
--secondary
Orange Accent
--accent
Success
--success
Semantic Colors
Background
--background
Muted
--muted
Border
--border
Destructive
--destructive
Status Backgrounds
Info / Active
bg-[#F0F9FA] border-[#D1EEF0]
Warning / Paused
bg-[#FEF3C7] border-[#FCD34D]
Success
bg-[#D1FAE5] border-[#6EE7B7]
Error / Destructive
bg-[#FEE2E2] border-[#FECACA]
Typography
Font families, sizes, and text styles following MUI v7 spec.
Headings
Heading 1 — 34px / 400
h1 · 2.125rem · letter-spacing: 0.00735em
Heading 2 — 24px / 400
h2 · 1.5rem · letter-spacing: 0
Heading 3 — 20px / 500
h3 · 1.25rem · letter-spacing: 0.0075em
Heading 4 — 18px / 500
h4 · 1.125rem · letter-spacing: 0.0075em
Body Text
Body 1 — 16px / 400 / 1.5 line-height
text-base · Default body text
Body 2 — 14px / 400 / 1.43 line-height
text-sm · Secondary body text
Caption — 12px / 400
text-xs · Captions and labels
Font Family
Roboto — Sans Serif (Default)
font-sans · --font-sans
Roboto Mono — Monospace
font-mono · --font-mono
Layout & Spacing
Border radius, shadows, and spacing utilities.
Border Radius
Shadows
Mobile vs Desktop Design Practices
Global responsive design standards differentiating mobile-first layouts from desktop experiences.
Button Stacking & Layout
Mobile Design
- • Buttons stack vertically:
flex-col - • Back button on top, Continue on bottom
- • Full width buttons:
w-full - • Pill-shaped corners:
rounded-full - • Increased vertical padding:
py-3 - • Larger tap targets for mobile
Desktop Design
- • Buttons inline:
sm:flex-row - • Side-by-side or spaced layout
- • Auto width:
sm:w-auto - • Standard corners:
sm:rounded-lg - • Compact padding:
sm:py-2 - • Optimized for mouse/keyboard
Text Handling
Text Standards
- ✓Never wrap text across multiple lines:
whitespace-nowrap - ✓Use sentence case for all titles and section headings
- ✓No icons to the left of section titles (interactive elements only)
- ✓Button text: "Continue" (not "Confirm and continue")
Spacing & Breakpoints
Mobile
0px - 639px
Full width, stacked layout, maximum touch targets
Tablet (sm)
640px - 1023px
Transition zone, flexible layouts
Desktop (md+)
1024px+
Constrained width, horizontal layouts
Implementation Checklist
Form Controls
Inputs, selects, checkboxes, and other form elements.
Text Inputs
Textarea
Select
Checkbox & Radio
Checkboxes
Radio Group
Switch
Slider
Value: 50
Feedback
Alerts, toasts, progress indicators, and loading states.
Alerts
Progress
Skeleton Loading
Data Display
Cards, badges, avatars, and other display components.
Badges
Avatars
Cards
This is the card content area where you can add any content.
Used for active states and important information.
Tabs
Accordion
Tooltip
Dialog
Dropdown Menu
Really Components
Project-specific composed components and surfaces, grouped by product area. These compose the primitives above into the actual experiences shipped on Really Global.
Marketplace & Discovery
Public-facing marketplace for finding providers.
Booking Flow
End-to-end booking with attestation, payment, and confirmation.
- View
Book Session Sidebar
components/booking/book-session-sidebar.tsx
- Sub-component
Booking Card
components/booking/booking-card.tsx
- Sub-component
Booking Confirm Panel
components/booking/booking-confirm-panel.tsx
- Sub-component
Booking Dialog
components/booking/booking-dialog.tsx
- Sub-component
Booking Trigger
components/booking/booking-trigger.tsx
- View
Location Attestation Block
components/booking/location-attestation-block.tsx
- Sub-component
Mobile Book Session Sheet
components/booking/mobile-book-session-sheet.tsx
- Sub-component
Mobile Floating Book Bar
components/booking/mobile-floating-book-bar.tsx
Provider Dashboard
Authenticated provider workspace and profile management.
Talk Now (RGDEV-386)
On-demand sessions: client flow, provider ring, and reliability scoring.
Onboarding
Provider onboarding wizard.
- View
Onboarding Steps
components/onboarding/
Icons
Commonly used Lucide icons throughout the platform.