spacing-system

Installation
SKILL.md

Spacing system

Spacing in a token-driven design system is a two-unit primitive problem, not a one-number guess. A token-driven system declares a minor unit (the smallest legal increment) and a major unit (the dominant rhythm), with the constraint that the major divides cleanly by the minor. Everything downstream — padding, gap, icon size, component height, border radius — derives from those two numbers.

When to use

  • Designing a new spacing scale from a density brief.
  • Auditing an existing scale with one-off off-grid values.
  • Picking unit primitives for a density mode (dense / balanced / spacious).
  • Code review: flag raw px values for padding / gap / margin outside the system's declared scale.

When NOT to use

  • No token layer on disk — no unit primitives declared anywhere, so there is no grid to be off of. A marketing surface built inside a system that has declared primitives is still in scope.
  • Print-design contexts where the grid math is pt-based and a different system applies.

The two-unit primitive model

A token-driven system declares two unit primitives per foundation theme:

Installs
9
GitHub Stars
3
First Seen
Aug 14, 2026