Design Guidelines - v1.0

Design
Guidelines

The visual language for the FTS Platform. A system built on clarity, restraint, and the belief that building compliance software should feel as considered as the buildings it tracks.

May 2026
First to Site
01
Colour

A palette grounded in authority. Navy anchors trust, green signals progress and compliance, and everything else stays quiet.

Brand

Primary - Navy
oklch(0.29 0.05 244)
Secondary - Green
oklch(0.64 0.17 140)
Destructive - Red
oklch(0.58 0.22 27)

Surfaces

BackgroundPage canvas
CardContent panels
MutedDisabled, headers
BorderDividers, edges
SidebarNavigation rail

Data Visualisation

Series 1
Series 2
Series 3
Series 4
Series 5
Design Decision

The palette is deliberately narrow. Navy conveys the authority that building compliance demands. Green is reserved for signals of progress: titled parcels, completed milestones, confirmed statuses. Red is only for things that need urgent attention. Every other surface stays neutral. If a colour appears on screen, it means something.

02
Typography

Two typefaces. One voice. Inter for the interface, JetBrains Mono for data. Nothing else.

Inter
Aa Bb Cc
The quick brown fox jumps over the lazy dog. 0123456789
JetBrains Mono
Aa Bb Cc
642\PS916557 • LOT 1041 • #500626
Heading 1
All Projects
2rem / 32px • Bold 700 • -0.02em tracking
Heading 2
Project Details
1.5rem / 24px • Semibold 600 • -0.01em tracking
Body
LOT 308 (13) PAUL AVENUE KEILOR EAST 3033 - Managed with full checklist tracking, document management, and order workflows.
0.875rem / 14px • Regular 400 • -0.01em tracking
Monospace Data
642\PS916557 - 6     SPI: 1041\PS842988     Client: #762378
0.8rem / 13px • JetBrains Mono 400 • Used for SPIs, lot numbers, client refs
Design Decision

Inter was chosen for its optical clarity at small sizes - most of this platform lives at 12-14px in dense data tables. JetBrains Mono handles the technical data layer: SPIs like 642\PS916557 need character-level precision that proportional fonts blur. The two never compete because they serve different information types.

03
Status System

Seven states. Each with a dedicated colour. A coloured dot prefix makes every status scannable at speed across dense data tables.

Titled
Parcel registration complete
Untitled
Awaiting registration
Indeterminate
Cannot be determined
Pending
Awaiting action
In Progress
Work underway
Complete
Work finished
Overdue
Past expected date
Design Decision

The dot-prefix pattern was chosen over solid-fill badges because users scan project lists of 50+ rows at speed. A small coloured dot in a soft-tinted pill registers faster than reading text, and the muted backgrounds prevent the page from becoming a rainbow. Green means good, amber means waiting, red means act now - no learning curve required.

04
Interactive Elements

Every interactive element uses one of five button variants. Forms keep inputs clean, consistent, and fast to scan.

Buttons

Form Controls

Design Decision

Primary (navy) is reserved for the single most important action on any page. Secondary (green) is for supporting actions like exports. Outline is for filters and toolbar items that shouldn't compete for attention. Ghost is for cancel and dismiss. Destructive only appears in confirmation dialogs, never in toolbars. This hierarchy means users always know where to click without reading.

05
Navigation

A dark sidebar anchors the interface. It's always there, always predictable, and uses green accents to show where you are.

Design Decision

The sidebar is permanently dark regardless of page theme. This creates a strong anchor point that never moves and never changes appearance. The green left-border on active items provides instant orientation. Count badges use the same green to draw attention to pending work without being aggressive. The sidebar collapses to an icon rail on smaller screens, preserving the dark anchor without stealing content space.

06
Spacing & Radius

A 4px grid creates rhythmic consistency. Corners are softened, never rounded - this is compliance software, not a toy.

Spacing Scale

4px
8px
12px
16px
24px
32px
48px

Border Radius

4px
sm
6px
md
8px
lg
10px
xl
pill
Design Decision

The base radius of 6px strikes the balance between approachable and professional. Everything inherits from a single --radius token, so changing the platform's personality from "sharp" to "soft" is a single number. The flat shadow system (zero opacity by default) keeps the interface clean and focused. If depth is needed later, one variable change activates it everywhere simultaneously.

07
Principles

The rules that every design decision follows.

Colour means something

If a colour appears, it carries a specific meaning. Green is always progress. Red is always urgency. Navy is always the primary action. There is no decorative colour.

Data density over decoration

Users manage hundreds of projects daily. Every pixel should serve information retrieval, not aesthetics. Whitespace is used to separate, not to impress.

One source of truth

Every colour, radius, and spacing value comes from a CSS variable. Change one token and the entire platform updates. No hardcoded values anywhere.

Status at a glance

A user scanning a 50-row table should know which rows need attention without reading a single word. The dot-prefix status system makes this possible.

First to Site Design Guidelines v1.0 - May 2026