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.

TokenValue (HSL)Tailwind classUsage
--background0 0% 100%backgroundApp / card background
--foreground222.2 84% 4.9%foregroundPrimary text
--primary248 83% 17%primaryBrand navy (buttons, ring)
--primary-foreground210 40% 98%primary-foregroundText on primary
--secondary210 40% 96%secondarySecondary surfaces
--muted210 40% 96%mutedMuted surfaces
--muted-foreground215.4 16.3% 46.9%muted-foregroundMuted text
--accent210 40% 96%accentHover surfaces
--destructive0 84.2% 60.2%destructiveDestructive actions
--border214.3 31.8% 91.4%borderBorders
--input214.3 31.8% 91.4%inputInput borders
--ring248 83% 17%ringFocus ring
--radius0.5remrounded-lgBase 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

LightRegularMediumSemiboldBold

Mono — font-mono

JetBrains Mono

#33295e · const value = 42;

Heading XLMulti-academy insight
Heading LSection heading
Heading MCard title
BodyStandard body text used across the platform.
Small / metaSecondary metadata and helper copy

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

Default
Secondary
Outline
Destructive

Inline status pills

NEWURGENTACTIVESystem

Form Controls

Inputs, selects and switches. Mark mandatory fields with a red asterisk; active toggles use brand navy across settings pages.

OnAlways navy — never pink

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.