Hartfield Design System

Quiet, exact, and built to be trusted.

The shared language for hartfield.ai and the Hartfield app. This build runs on HeroUI v3 on React Aria; the tokens, type and patterns are the same on both.

01

Principles

Hartfield holds alarm codes, vehicle titles and the location of a family's belongings. The interface should feel like a well-run private office — never like a consumer app asking for attention.

Paper and ink

Warm neutrals do nearly all the work. Colour is reserved for status, so when something is amber or red it means something.

Serif for the household, sans for the work

Names of homes, page titles and numbers are set in serif. Everything you operate — labels, tables, buttons — is sans.

Answers before navigation

Every surface leads with what needs attention and a way to ask. Lists and records sit one level down.

02

Brand

The mark is an arch — a doorway, a gate, the thing you are let through. It pairs with a serif wordmark and appears only in ink or paper.

Wordmark

Outlined from Newsreader with the f joined to a dotless i. Always use the outline, never live text. Files are in public/brand in ink, paper and currentColor.

Mark explorations

Six directions on one 24px grid and one stroke weight. Each is shown at 64, 24 and 16px, reversed, and locked up with the wordmark. Arch is the current default.

A Arch

A doorway. Access, and the people you let through it.

B Gable

An H with a roofline for a crossbar. The initial and the home in one.

C Hart

Antlers. A hart is a stag — heraldic, a family crest.

D Field

Rows running to a horizon under a low sun. Land, order, a long view.

E Keyhole

Privacy first. Everything is kept, and only some of it is shown.

F Two roofs

More than one home, seen together. The most literal of the six.

03

Colour

A single warm-neutral ramp from paper to ink, a small set of deep estate tones for imagery and panels, and four signals that are only ever used to communicate state.

Stone

The neutral ramp. 50 is the page, 950 is text and primary actions.

50 Paper

#faf9f7

100

#f2f0ec

200

#e6e3dd

300

#cfcbc3

400

#aeaaa1

500

#8d8980

600

#6e6a62

700

#504d46

800

#32302b

900

#1e1c19

950 Ink

#100f0d

Estate tones

Deep, muted colour for panels, property headers and charts. Never for buttons or text links.

Evergreen

evergreen · #2e3d36

Bronze

bronze · #5a4136

Slate

slate · #333d47

Plum

plum · #3d3340

Sage

sage · #d5dcd6

Sand

sand · #e3d9cc

Signals

Each has a solid, a soft fill and a text colour that passes AA on the soft fill.

Aa

Success

Done, healthy, covered

Aa

Warning

Due soon, needs a look

Aa

Danger

Overdue, expired, at risk

Aa

Info

Suggested by Hartfield

Semantic roles

The names HeroUI v3 on React Aria components read. Product patterns use the library-neutral set, so they look the same on either.

Light

  • backgroundPage
  • surfaceRaised surface
  • defaultNeutral fill
  • borderHairline
  • field-borderControl edge
  • mutedSecondary text
  • accentPrimary action
  • foregroundText

Dark

  • backgroundPage
  • surfaceRaised surface
  • defaultNeutral fill
  • borderHairline
  • field-borderControl edge
  • mutedSecondary text
  • accentPrimary action
  • foregroundText

04

Typography

Newsreader for display and headings — regular weight, tight leading, slight negative tracking. Geist for everything functional. Two weights only: 400 and 500.

Serif — Newsreader

Aa

ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz
0123456789 — & ’ “ ”

Sans — Geist

Aa

ABCDEFGHIJKLMNOPQRSTUVWXYZ
abcdefghijklmnopqrstuvwxyz
0123456789 — & ’ “ ”

Display

.type-display

Serif 400 · 44–80 / 1.05 · −1.25%

Every home, in order.

Heading 1

.type-h1

Serif 400 · 36–56 / 1.05 · −1%

One place for the whole household

Heading 2

.type-h2

Serif 400 · 28–36 / 1.08 · −1%

Know what is where, and who can reach it

Heading 3

.type-h3

Serif 400 · 24–28 / 1.1 · −1%

Castle Pines, Colorado

Section

.type-section

Sans 500 · 26–36 / 1.1 · −1%

What Hartfield keeps track of

Stat

.type-stat

Serif 400 · 44–72 / 1 · −2%

27

Heading 4

.type-h4

Sans 500 · 20 / 1.2 · −1%

Vehicles kept at this home

Title

.type-title

Sans 500 · 16 / 1.3

Pool service — every Tuesday

Lead

.type-lead

Sans 400 · 18–20 / 1.3

Hartfield keeps the details of every home, so the people you trust can act without asking.

Body

.type-body

Sans 400 · 16 / 1.4

The main water shut-off is in the garage, left of the water heater, behind the grey panel.

Body small

.type-body-sm

Sans 400 · 14 / 1.43

Registration expires 31 December. Renewal notice is filed under Documents.

Label

.type-label

Sans 500 · 14 / 1.3 · −1%

Assigned to

Caption

.type-caption

Sans 400 · 12 / 1.35

Updated 40 minutes ago by Avery

Mono

.type-mono

Mono 400 · 13 / 1.4

VIN 1HGCM82633A004352

05

Shape & space

Small radii, hairline borders and almost no shadow. Nested corners share a centre: inner radius is outer radius minus the inset. How things move is in the Motion section that follows.

Radius

Controls are 4px. Cards and panels are 12px. Nothing is pill-shaped except avatars and switches.

xs

2px

sm

4px · controls

md

6px · nav items

lg

8px · tiles

xl

12px · cards

2xl

16px · sheets

Elevation

Three levels. Most surfaces use the first, with a border.

card

Resting cards

raised

Hover, focused composer

overlay

Menus, dialogs, sheets

Spacing

A 4px base. Section rhythm and page gutters step up with the viewport.

14px
28px
312px
416px
520px · card padding
832px
1248px
section-sm48 → 80px
section72 → 140px

Layout

Marketing pages sit in a 12-column grid inside a 1728px cap; section content caps at 1200px.

Page cap

1728px

Content

1200px

Prose

672px

Gutter

20 → 36px

Header

72px

App sidebar

256px

Row height

56px

Breakpoints

432 · 768 · 1024

06

Motion

Nothing teleports. Four curves and five durations cover every transition, and six hover behaviours cover everything the pointer can touch. Components use the utilities below; none writes its own timing.

Curves

Hover the panel to run all four over the same distance and time.

  • Out

    --ease-out · cubic-bezier(0.16, 1, 0.3, 1)

    The default. Hovers, entrances, anything answering the pointer.

  • In-out

    --ease-in-out · cubic-bezier(0.65, 0, 0.35, 1)

    Things that move or resize in place: accordions, menus, carousels.

  • Soft

    --ease-soft · cubic-bezier(0.3, 0.3, 0.3, 1)

    Opacity-only fades and long, large movements.

  • Exit

    --ease-exit · cubic-bezier(0.5, 0, 0.75, 0)

    Things leaving: closing menus, dismissed rows.

Durations

Shorter for small, frequent changes; longer as more of the screen moves.

  • Press

    100ms

    --duration-press
    Pressed state

  • Fast

    180ms

    --duration-fast
    Colour, underline, icon nudge

  • Base

    280ms

    --duration-base
    Lift, shadow, border

  • Slow

    480ms

    --duration-slow
    Expand, enter, cross-fade

  • Reveal

    800ms

    --duration-reveal
    Entering the viewport, image zoom

Hover

Pick the behaviour that matches what the element is. All six apply only where a pointer can hover, and ease back out the same way.

  • HVAC filter change
  • Renew registration
  • Gate procedure

hover-tint

Rows, menu items, quiet buttons.

Castle Pines

Second home · 3 open tasks

hover-lift

Cards that open something. Rises 2px.

Learn more

hover-underline · hover-arrow

Text links inside a group. The line firms up; the arrow moves 3px.

A sofa in low evening light beside tall windows and a concrete wall

Kailua Bay

hover-zoom

A photo inside a group. Scales 3% over 800ms.

press

Anything pressable. Settles 2% in 100ms. HeroUI buttons already do this.

Rules

  • One hover behaviour per element.
  • Never animate layout on hover; only colour, shadow, position and scale.
  • Hover in and hover out use the same curve.
  • With reduced motion on, everything changes at once.

Arriving

Content that enters the page or mounts after an action.

<Reveal>

Marketing content entering the viewport. Fades up 16px over 800ms, once.

enter

Content that mounts after an action, such as an answer or a new row. Fades up 12px over 480ms.

motion-expand

Height, grid rows and cross-fades: accordions, menus, switching panels. 480ms, in-out.

07

Components

Primitives come from the @heroui/react package and are themed through CSS variables in src/app/(heroui)/heroui.css, plus a few class overrides for shape and hover.

Button

HeroUI’s variants: primary, secondary, tertiary, outline, ghost, danger. Themed to ink with 4px corners; heights are HeroUI’s own.

Chip

HeroUI’s badge. Soft variant with a dot for status; secondary and tertiary for categories. There is no info colour, so ‘suggested’ uses accent.

All clearDue in 9 daysExpiredSuggestedScheduledLandscapingPrimary residenceOwner

Form controls

TextField composes Label, Input, Description and FieldError and wires the ARIA for you. Themed to a white fill, 1px border and 4px radius.

Shown everywhere this home appears.
That doesn’t match the format on the insurance card.

Switch & access row

Access is granted per person, per area. Sensitive items show who can see them — never the value.

Tabs

Primary is the segmented control; secondary is the underlined set for sections of a record.

Seven open tasks across three homes.

Avatar & card

Card is HeroUI’s Surface with Header, Title, Description and Content parts.

People with access

Castle Pines · 4 people

EWJWALMR

Ice maker — Sub-Zero UC-15I

Installed March 2021 · Kitchen

Warranty ends in 4 monthsAppliance

08

Interactive

Overlays and stateful controls, wired up. Everything here opens, filters, saves and confirms — keyboard included.

Modal, select, switch

A real form in a modal: type a name, pick a role, toggle areas, save. Escape and the backdrop close it; focus is trapped while open.

Filter and row menu

The select filters the list. Each row’s menu acts on it and confirms with a toast. Arrow keys and type-ahead work in both.

5 tasks · All homes

Renew registration — Range Rover

Desert Ridge · Avery

9 days

Winterise sprinklers

Castle Pines · Front Range Landscape

Suggested

HVAC filter change

Castle Pines · Summit Mechanical

Fri

Pool service

Kailua Bay · Blue Reef Pools

Done

Arizona licence — Koda

Desert Ridge · Unassigned

Overdue

Checklist

Opening the house. Checkboxes keep their own state and the count updates as you go.

Opening Castle Pines

2 of 6

09

Patterns

Product-specific building blocks in src/components/hartfield. They use only the shared tokens, so they are the same code on both libraries — only the chips come from the library.

Estate panel

The signature surface: a deep tone, fine grain, a wash of light. Frames product imagery and stands in for a photo.

evergreen
bronze
slate
plum

Property card

A photo under a dark scrim (or an estate tone when there is none), the name in serif, the role of the home, and the three facts that answer “what needs me here?”.

A living room with earth walls opening onto a terrace in a desert canyon
Primary residenceAll clear

Desert Ridge

Scottsdale, Arizona

Open tasks
2
Vehicles here
3
Next visit
Home
A stone and timber house lit from within, among snow-covered pines at dusk
Second homeFreeze Thursday

Castle Pines

Castle Pines, Colorado

Open tasks
4
Vehicles here
2
Next visit
Dec 19
A bathroom with a freestanding tub looking out over the sea
SeasonalAll clear

Kailua Bay

Kailua, Hawaiʻi

Open tasks
1
Vehicles here
—
Next visit
Feb 02

Stat card

One serif number, one label. Use in rows of three or four at the top of a view.

3

Homes

2 occupied this week

7

Open tasks

2 due this week

131 Dec

Expiring soon

Vehicle registration

12

Vendors on file

All insured

List row

56px. Icon tile, one line of title, one of context, status on the right.

Winterise sprinklers and disconnect hoses

Castle Pines · Suggested from Thursday’s freeze forecast

Suggested

Renew registration — Range Rover

Desert Ridge · Plates expire 31 December

Due in 9 days

Rabies booster and Arizona licence — Koda

Pets · Records on file from last year

Overdue

Pool service

Kailua Bay · Every Tuesday · Blue Reef Pools

Done

Ask bar

The front door to the household’s knowledge. Always states what it is answering from. Try a suggestion or type a question.

Answering fromCastle Pines · 3 manuals, 41 documents

10

In context

The same tokens at marketing scale and at product density.

Marketing

Left-aligned serif display, a short lead on the right, product framed on an estate panel.

Every home, in order.

A private record of your homes, vehicles and belongings that answers questions and tells you what needs doing.

The Whitlock household

1 needs a look
3

Homes

7

Open tasks

5

Vehicles

Application

Ink sidebar, stone canvas, white cards. The view opens with what needs attention. The ask bar here is live.

Good morning, Eleanor

Hard freeze forecast for Castle Pines on Thursday night

Sprinklers are still on and two hoses are connected. Front Range Landscape hasn’t been notified.

This week

Across all three homes

Renew registration — Range Rover

Desert Ridge · Avery

9 days

Arizona licence — Koda

Pets · Unassigned

Overdue

HVAC filter change

Castle Pines · Summit Mechanical

Fri
3

Homes

7

Open tasks