McKinney Fix-It Pros · design systemguide
chapter 0

First principles

0.1 The company in first principles

McKinney Fix-It Pros sends one crew to a home to finish a list of small repairs. What the customer buys can be written as one line:

items on the list × minutes to a reply × days to the visit × one quoted price, minus the callback.

Every surface must let a reader test one claim: "One call clears the whole list: quoted first, done right, cleaned up."

The live brand already has a slate and near-black palette on light grey, two sans-serif typefaces and a badge logo. This version evolves it (confirmed by the owner, 2026-11-16): the measured colours and typefaces stay, defects are fixed, ramps and rules are added, and the logo is redrawn as a vector.

0.2 Five design laws

When a situation is not covered by a rule in this document, apply the laws.

  1. Say the job, the price, the day. Every surface names what will be done, what it costs or how the price is set, and when. Adjectives do not replace any of the three.
  2. A promise comes with its test. Each promise is shown next to how the customer can check it and what basis it rests on.
  3. Terracotta marks the one thing to do. One filled terracotta action per view. If two things are terracotta, one of them is wrong.
  4. Show the work, then the result. Photographs show hands, tools and the finished repair in a real home. No posed smiles, no handshakes.
  5. Leave it cleaner than we found it. Layouts are tidy: one grid, one type scale, generous space, nothing decorative that does not label or explain.

0.3 The ladder

A sceptical homeowner asks five questions in order. Each surface answers as many as it has room for, in this order.

Rung Reader's question What the surface shows Type treatment
1 Claim What do you do for me? "One call clears the whole list." Display, largest on the surface
2 Units How fast, how much, how many? 60 min reply · 1 written price · 9 kinds of repair · 6 days Display numerals with a unit line
3 Promises Why should I believe it? Each promise with how to check it Table, reading face
4 Basis What is that based on? The basis tag: Linked, On file, Our word Small caps tag
5 The test How would I know you failed? "When we have failed" block Boxed paragraph
Surface Rungs
Landing page 1–5
Service page 1–3
Customer portal The screen's question, then 2–3
Owner dashboard 2–5
One-pager, trifold 1–5
Social post, ad, door hanger 1, sometimes one number from 2
Email 1, 2, 5
Truck, uniform, swag, yard sign 1 as the logo alone

0.4 Basis tags

A number or promise shown without a basis tag is a defect.

Tag Meaning Example
Linked A public source anyone can open Review count linked to the review platform
On file A document the company holds and will send on request Certificate of insurance
Our word Company policy, tested by the customer's own experience Reply within 60 minutes

0.5 What changed from the live site

Area Before (measured) Now
Accent Terracotta #B05D45 and amber #E2A03F both used for emphasis Terracotta is the single accent; amber is for review stars only
Small grey text #8BA4BE and #9BB1C8 on light surfaces, about 2.6:1 and 2.2:1 text-tertiary #6E7378 at 4.54:1 (AA)
Button label 16 px bold white on #B05D45, 4.43:1 19 px bold (large text), or the accent-strong fill for smaller labels
Logo Grey raster WebP, 350 × 154 Vector masters in four colourways plus a compact mark (pending sign-off)
Claims "#1", "most trusted", "licensed" Removed; promises are stated with a test and a basis
Proof numbers 500+ and 2,500+ projects on different pages Not shown until one sourced number exists