First principles
- 0.1 The company in first principles
- 0.2 Five design laws
- 0.3 The ladder
- 0.4 Basis tags
- 0.5 What changed from the live site
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.
- 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.
- A promise comes with its test. Each promise is shown next to how the customer can check it and what basis it rests on.
- Terracotta marks the one thing to do. One filled terracotta action per view. If two things are terracotta, one of them is wrong.
- Show the work, then the result. Photographs show hands, tools and the finished repair in a real home. No posed smiles, no handshakes.
- 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 |
| 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 |