McKinney Fix-It Pros · design systemguide
chapter 5

Components

5.1 Buttons

Variant Fill Label Height Use
Primary accent on-accent, 19 px / 700 48 px min The one action in the view: call, send, approve
Primary small accent-strong on-accent, 16 px / 700 40 px Ad units and dense tables only
Ghost none; 2 px hair-strong border text, 19 px / 700 48 px The second option beside a primary
Text link none text with a terracotta underline n/a Inline

States: hover darkens the fill to accent-hover; active moves 1 px down; focus-visible shows a 3 px focus ring with 2 px offset; disabled drops to 45% opacity and loses the pointer; loading swaps the label for the busy bar and keeps the width.

5.2 Inputs

48 px tall, 16 px text, 1.5 px hair-strong border, 8 px radius, label always visible above (no placeholder-only labels). Error: border and message in status-critical with the octagon icon and a sentence that says how to fix it. The "add a photo" and "add another item" rows use a dashed border because they add rather than edit.

5.3 Cards and stat cards

Card: surface-raised, 1 px hair, 16 px radius, 24–32 px padding. Stat card: label (12/16, tertiary), figure (display numerals), one line of context. Exactly one stat card per view may carry the terracotta border and figure, and only when it is the finding.

5.4 Navigation

Marketing: logo left, four links, phone number right; on mobile the phone number stays visible and links collapse. Portal: bottom tabs (List, Quote, Visits, Account) with a terracotta dot on the active tab. Dashboard: slate top bar, light sidebar with the active item on a slate wash.

5.5 Tables, tags, feedback

Tables: uppercase 11–12 px headers, hairline rows, numbers right-aligned in tabular figures, a Source or Basis column on any table with promises or metrics. Basis tag: dot plus uppercase label. Toast: bottom centre, 200 ms in, says what happened ("Quote approved"). Empty state: one topic icon, one sentence, one action.

5.6 The signature element: the ticked list

The brand's own device is a checklist whose items tick as work is done. It appears as the portal's main screen, the door hanger's back, the notepad and the punch-list icon. The tick draws once (motion 8, chapter 16); it never bounces.

5.7 States checklist

Rest, hover, active, focus-visible, disabled, loading, error, selected, reduced motion, forced colours. A component is not finished until each is designed.