McKinney Fix-It Pros · design systemguide
chapter 15

Governance

15.1 Source of truth

tokens/tokens.json (W3C design-token format) is the source. tokens.css, color_math.json, print.csv and palette.html are generated by color_system.py from tokens/color-input.json and tokens/extra.json; they are never edited by hand. Templates are generated by templates/build_templates.py. This document is generated by docs_src/build_doc.py.

15.2 Naming

--mfp-<category>-<concept>-<variant>. Components use the role and alias tokens (--mfp-text-secondary, --mfp-alias-band), not raw ramp steps, except in charts.

15.3 Versioning

Major: a core colour, typeface or the logo changes. Minor: tokens or surfaces are added. Patch: corrections.

15.4 Change process

Propose the change with the surface it fixes → check it against the five laws → change the token or template source → regenerate → run qa_check.py → note it in the changelog.

15.5 Review checklist

15.6 Defect classes

Blocking: contrast failure; status by colour alone; a number without a basis on a published surface; a concept render presented as a real job; "licensed" without a number. Major: off-token colour; a second terracotta element; a redrawn or misspelt logo. Minor: casing slips; one off-grid value.

15.7 Open items

# Item Needed from
1 Sign-off on the redrawn logo Owner
2 Founding year ("Est. 2008" on the old badge) Owner
3 Review count with a linked platform Owner
4 One sourced project count (the site shows both 500+ and 2,500+) Owner
5 Phone number: (725) is a Nevada area code; consider a 214, 469 or 972 number Owner
6 Certificate of insurance and screening provider on file, to support the "On file" tags Owner
7 Postal address for the email footer Owner
8 Social handles Owner
9 Vinyl and thread reference numbers, confirmed on physical swatches Sign shop, embroiderer
10 Real photography to replace concept renders Photographer
11 The local repository uses navy #1B2A46, orange #FF6B35 and Inter; this system follows the live site instead Developer
12 Icons to refine in v1.1: hammer, shelf, trim Designer
13 Technicians in the renders are not varied enough; widen in the next batch Designer

15.8 Changelog