Guide / Controls / Reference

Style Rules

Machine-checkable rules distilled from the 16-chapter playbook. Each rule in the frontmatter names the thing it checks (check), the layout path it reads (target), the comparison (op), the limit (threshold), how loud a breach is (severity), and the reason (why) with the playbook chapter it comes from.

Symbol
checkmark.seal.fill
Docs
Docs in progress

Use them in this order when you build a layout:

  1. Choose the pack in Theming and the themes/ docs, then keep to one accent in both schemes (one-accent, accent-same-both-schemes).
  2. Hold the surfaces to the house ladder: card alpha 0F to 24 in dark, borderWidth 1 or less, cornerRadius 14 to 16, controlPadding 12 or less.
  3. Size the grid in points: a cell n rows tall is 64n - 8 at the default rowHeight of 56, and an iPhone tab holds 10 rows at most.
  4. Design both schemes, or pin appearance.colorScheme (light-dark-parity).
  5. Check contrast on every gradient stop (text-contrast), then score the five rubric axes (ship-bar).

The art-direction packs (Bauhaus, Terminal Phosphor, Swiss Rail Board and the rest) break the shape rules on purpose: square corners, 2 pt radius, no glass. They keep the other rules. Their frontmatter lists the values they set so a checker can tell a deliberate choice from a drift.

Generated from ControlDocs/style-rules.md. Something unclear or missing? Tell me.