Style Guide
The single source of truth for colours, typography, components and patterns. Reference this when building new pages to keep the platform consistent.
Colours
Click any swatch to copy its hex value. Brand colours drive primary actions and identity; neutrals form the slate-based UI foundation.
Brand
Brand gradient
linear-gradient(90deg, #33295e, #fd6d6d)
Used for hero headers, modal banners and the AI assistant.
Neutrals (Slate)
Status & Feedback
Report Category Palette
Rotating accent colours for report categories, charts and data visualisations.
Theme Tokens
Semantic CSS variables (defined in globals.css) power shadcn/ui components. Prefer these tokens over hard-coded colours so theming stays consistent.
| Token | Value (HSL) | Tailwind class | Usage |
|---|---|---|---|
| --background | 0 0% 100% | background | App / card background |
| --foreground | 222.2 84% 4.9% | foreground | Primary text |
| --primary | 248 83% 17% | primary | Brand navy (buttons, ring) |
| --primary-foreground | 210 40% 98% | primary-foreground | Text on primary |
| --secondary | 210 40% 96% | secondary | Secondary surfaces |
| --muted | 210 40% 96% | muted | Muted surfaces |
| --muted-foreground | 215.4 16.3% 46.9% | muted-foreground | Muted text |
| --accent | 210 40% 96% | accent | Hover surfaces |
| --destructive | 0 84.2% 60.2% | destructive | Destructive actions |
| --border | 214.3 31.8% 91.4% | border | Borders |
| --input | 214.3 31.8% 91.4% | input | Input borders |
| --ring | 248 83% 17% | ring | Focus ring |
| --radius | 0.5rem | rounded-lg | Base corner radius |
Typography
Poppins is the primary sans-serif typeface; JetBrains Mono is used for code and hex values. Body line-height stays relaxed for readability.
Sans — font-sans
Poppins
Weights: 300 · 400 · 500 · 600 · 700
Mono — font-mono
JetBrains Mono
#33295e · const value = 42;
Buttons
Primary actions use the brand navy. Use variants for hierarchy: default for the main action, outline/secondary for supporting actions, ghost for low-emphasis.
Variants
Sizes
States
Badges & Tags
Small status indicators. Use semantic variants for system states, and coloured pill tags for inline labels like NEW, URGENT or ACTIVE.
Variants
Inline status pills
Form Controls
Inputs, selects and switches. Mark mandatory fields with a red asterisk; active toggles use brand navy across settings pages.
Surfaces & Radius
Cards sit on a slate-50 background with white surfaces, slate-200 borders and a base radius of 0.5rem (rounded-lg).
rounded-md
calc(0.5rem - 2px)
rounded-lg
0.5rem (base)
rounded-full + shadow-sm
Pills, avatars, FAB
No elevation
Default cards — border only
shadow-sm
Hover / raised surfaces
shadow-lg
Modals, popovers, FAB
Iconography
Keep the interface clean and text-led. Do not add decorative icons to new pages or components.
Rule: no decorative icons
Do not add icons going forward — no coloured icon tiles next to list items, no leading icons on rows, cards, suggestions or table cells, and no purely decorative glyphs. Lead with clear text labels instead. This keeps screens uncluttered and consistent across the platform.
Do
- Use text labels and badges to convey type or status.
- Rely on spacing, weight and colour for hierarchy.
- Keep list rows and cards icon-free.
Don't
- Add coloured icon squares beside item names.
- Prefix suggestions or menu rows with glyphs.
- Introduce new decorative icons to fill space.
Note: small functional controls that are clearly understood (e.g. a delete action or a search field affordance) may keep their icon where it aids usability — the rule targets decorative and category/type icons.