design system
McKinney Fix-It Pros
This system was built from the live site at mckinneyfixitpros.com on 16 November 2026. Colours were measured from the rendered pages by painted area and by text length; type was measured from the two font files the site serves; contrast, colour-vision separation and print starting values were computed from those inputs. The brand owner confirmed the brief the same day. Where a value is a recommendation rather than a measurement it says so.
| You are | Read | Then use |
|---|---|---|
| The owner | Chapter 0, 14, 15 | The open items in 15.7 |
| A web or app developer | 1, 3, 4, 5, 13, 16 | tokens/tokens.css, tokens/motion.css, icons/ |
| A designer or agency | 0–6, 12, 17–20 | templates/, logo/ |
| A printer, sign shop or embroiderer | 1.8, 2, 10, 11 | logo/*.svg, tokens/print.csv |
| Whoever posts on social | 12, 14, 18 | templates/social/ |
The laws
- Say the job, the price, the day
- A promise comes with its test
- Terracotta marks the one thing to do
- Show the work, then the result
- Leave it cleaner than we found it
Chapters
- chapter 0First principlesMcKinney 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:…
- chapter 1Colour management systemThe colour law: paper is the room, slate is the frame, ink is the voice, terracotta is the one thing to do.…
- chapter 2Logo, mark and usageA gear with a crossed hammer and wrench, beside the name in two lines of capitals with a lowercase "c", over the descriptor "Handyman & Repa…
- chapter 3TypographyMeasured from the live site: both families are served as variable WOFF2 and every text element renders in one of them. There is no mismatch …
- chapter 4Layout, spacing, grids and image sizingBase unit 4 px. Scale tokens space-1 (4) to space-40 (160): 4, 8, 12, 16, 20, 24, 32, 40, 48, 64, 80, 96, 128, 160, plus space-gutter clamp(…
- chapter 5ComponentsStates: 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 dro…
- chapter 6Websites and landing pagesMeasured 2026-11-16: eight pages crawled (home, about, contact, projects, services, locations, two service pages). A dark hero with a truck …
- chapter 7Functional appsA phone-first web app. Each screen is named for the question the customer opens it to answer.…
- chapter 8Dashboards (after Tufte)Title as a question ("Are we keeping the promise?") and a one-sentence answer → filter chips → verdict strip of six stat cards with exactly …
- chapter 9Data visualisationColour: single series in slate-400; the finding in terracotta; categories from 1.7 in fixed order. Marks: bars with 3 px radius, lines 2 px,…
- chapter 10Infographics, one-pagers, brochures, slides, documents<figure><img src="docs/img/sheet-print.jpg" alt="Contact sheet of print pieces: one-pager, door hanger front and back, business card, yard s…
- chapter 11Swag and physical objectsObjects carry the logo or the gear and nothing else. No slogans, no URLs, no patterns.…
- chapter 12Imagery, illustration and alt text<figure><img src="docs/img/sheet-photography.jpg" alt="Contact sheet of twenty photography concept renders: technicians repairing drywall, m…
- chapter 13Accessibility, motion and interaction statesTarget: WCAG 2.2 AA (recommended and confirmed). Many customers are older and on a phone, so the system goes further on size: body text 16 p…
- chapter 14Voice and contentVoice in one line: a capable neighbour who tells you the job, the price and the day.…
- chapter 15GovernanceMajor: a core colour, typeface or the logo changes. Minor: tokens or surfaces are added. Patch: corrections.…
- chapter 16Motion libraryPrinciple: done, not dazzling. Motion confirms that something happened. Nothing loops except the busy bar and the skeleton shimmer.…
- chapter 17Custom icon libraryPrinciple: icons label; they do not decorate. 72 icons drawn for this company on a 24 px grid: 2 px stroke, round caps and joins, 2 px corne…
- chapter 18Social libraryPrinciple: one idea per post, on slate, with the logo bottom left.…
- chapter 19Advertising libraryPrinciple: one claim, one verb, the logo once, terracotta once.…
- chapter 20EmailPrinciple: one job for the reader, one button.…