
Desert Ridge
Scottsdale, Arizona
- Open tasks
- 2
- Vehicles here
- 3
- Next visit
- Home
Hartfield Design System
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
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.
Warm neutrals do nearly all the work. Colour is reserved for status, so when something is amber or red it means something.
Names of homes, page titles and numbers are set in serif. Everything you operate — labels, tables, buttons — is sans.
Every surface leads with what needs attention and a way to ask. Lists and records sit one level down.
02
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.
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.
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
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.
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
Deep, muted colour for panels, property headers and charts. Never for buttons or text links.
evergreen · #2e3d36
bronze · #5a4136
slate · #333d47
plum · #3d3340
sage · #d5dcd6
sand · #e3d9cc
Each has a solid, a soft fill and a text colour that passes AA on the soft fill.
Success
Done, healthy, covered
Warning
Due soon, needs a look
Danger
Overdue, expired, at risk
Info
Suggested by Hartfield
The names HeroUI v3 on React Aria components read. Product patterns use the library-neutral set, so they look the same on either.
Light
Dark
04
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
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.
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
Three levels. Most surfaces use the first, with a border.
card
Resting cards
raised
Hover, focused composer
A 4px base. Section rhythm and page gutters step up with the viewport.
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
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.
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.
Shorter for small, frequent changes; longer as more of the screen moves.
Press
--duration-press
Pressed state
Fast
--duration-fast
Colour, underline, icon nudge
Base
--duration-base
Lift, shadow, border
Slow
--duration-slow
Expand, enter, cross-fade
Reveal
--duration-reveal
Entering the viewport, image zoom
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.
hover-tint
Rows, menu items, quiet buttons.
Castle Pines
Second home · 3 open tasks
hover-lift
Cards that open something. Rises 2px.
hover-underline · hover-arrow
Text links inside a group. The line firms up; the arrow moves 3px.

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
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
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.
HeroUI’s variants: primary, secondary, tertiary, outline, ghost, danger. Themed to ink with 4px corners; heights are HeroUI’s own.
HeroUI’s badge. Soft variant with a dot for status; secondary and tertiary for categories. There is no info colour, so ‘suggested’ uses accent.
TextField composes Label, Input, Description and FieldError and wires the ARIA for you. Themed to a white fill, 1px border and 4px radius.
Access is granted per person, per area. Sensitive items show who can see them — never the value.
Primary is the segmented control; secondary is the underlined set for sections of a record.
Card is HeroUI’s Surface with Header, Title, Description and Content parts.
Castle Pines · 4 people
Installed March 2021 · Kitchen
08
Overlays and stateful controls, wired up. Everything here opens, filters, saves and confirms — keyboard included.
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.
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
Winterise sprinklers
Castle Pines · Front Range Landscape
HVAC filter change
Castle Pines · Summit Mechanical
Pool service
Kailua Bay · Blue Reef Pools
Arizona licence — Koda
Desert Ridge · Unassigned
Opening the house. Checkboxes keep their own state and the count updates as you go.
Opening Castle Pines
2 of 6
09
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.
The signature surface: a deep tone, fine grain, a wash of light. Frames product imagery and stands in for a photo.
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?”.

Scottsdale, Arizona

Castle Pines, Colorado

Kailua, Hawaiʻi
One serif number, one label. Use in rows of three or four at the top of a view.
Homes
2 occupied this week
Open tasks
2 due this week
Expiring soon
Vehicle registration
Vendors on file
All insured
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
Renew registration — Range Rover
Desert Ridge · Plates expire 31 December
Rabies booster and Arizona licence — Koda
Pets · Records on file from last year
Pool service
Kailua Bay · Every Tuesday · Blue Reef Pools
The front door to the household’s knowledge. Always states what it is answering from. Try a suggestion or type a question.
10
The same tokens at marketing scale and at product density.
Left-aligned serif display, a short lead on the right, product framed on an estate panel.
A private record of your homes, vehicles and belongings that answers questions and tells you what needs doing.
Ink sidebar, stone canvas, white cards. The view opens with what needs attention. The ask bar here is live.
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
Arizona licence — Koda
Pets · Unassigned
HVAC filter change
Castle Pines · Summit Mechanical
Homes
Open tasks