--space-label-gap (7,
dense 5) and the rule for sibling items were derived from the number rule, and they are pending the
owner’s confirmation. The comparison with WCAG 2.2, Apple, Material 3 and Anthropic’s brand is on
the standards comparison.
The number rule
Every Mzizi spacing or size value is a multiple of 3, a multiple of 7, or a prime number.- Start from the recommended value: WCAG, Apple HIG or Material 3.
- Take the nearest Mzizi number at or above it. A little larger is fine. Lower never is.
- Cards, containers and page layout use multiples of 7. Controls may use any Mzizi number, so they can sit tighter.
Density
White space where it serves the reader, and dense where the content needs it. A dense screen is a screen of data, a long list or a table. A default screen is one that a person reads at leisure or touches with a thumb. Both densities are supported by the same components, and the choice is the layer’s, not the app’s. Each layer has a default value and a dense value, and both are floors:- The default is the floor at default density.
- The dense value is the absolute floor. Nothing goes below it, at any density.
- Where a layer has no dense step, its default is the floor at every density.
<token>-dense, for example --space-card-dense.
The layers
Controls are buttons, chips and inputs. Cards are cards, list items and tiles. Containers are dialogs, sheets and panels. Layout is the page edge and the gaps between sections. Pills and badges are their own small layer.
Where the dense column reads ”—”, the default is the floor at every density. Sibling items in a
list, grid or toolbar take the card gap,
--space-card-gap (14, dense 7), so no separate token
exists for them.
The hit-area floors
A control’s hit region is a floor of its own. It depends on the pointer, not on the layer or the density.
WCAG 2.5.5 and Apple ask for 44 on touch, and 45 is the nearest Mzizi number above it. WCAG 2.5.8
asks for 24 on a desktop, and 24 is 3 × 8.
Control heights on the rule
Five control heights were off the rule and now round up to the nearest Mzizi number. The other heights already on the rule stay as they are.
Already valid: 36, 28, 48 and 56.
What changed
Body text, captions, contrast and line height do not change. Body stays at 17px on touch and 15px
on a desktop, captions at 14px, contrast at 7:1 for body text, 4.5:1 for other text and 3:1 for UI,
and the body line height at 1.5.
Screens built on the old values get slightly roomier. Nothing breaks.
Enforcement
A layer-aware checker ships together with the tokens. Each component is checked against its own layer’s dense floor. Where a component’s layer is unknown, the global floor never drops below the 14px inset and the 7px gap.Where the values are served
Registry 4.45 and later: the tokens,registry.json, and /v1/brand once api.mzizi.dev pins 4.45.
The registry generates the tokens to CSS, Rust and React Native from one source. The registry’s
tests check that the numbers agree between
BUNDU_FLOOR, canon, /v1/tokens and the stylesheet.
The contract and geometry tests for spacing are tracked in
mzizi-registry#617.
The base layer and the legacy opt-out
A barebutton, select, textarea or text input takes the inset floor on its inline axis, a
bare text surface takes it on both axes, and a list, group, toolbar or tablist takes the gap floor.
The line height of body is at least the 1.5 floor.
data-mzizi-sizes="legacy" on the root element sets the inset, gap and leading floors to 0, 0 and
1, so the base-layer rules do nothing. It steps out of the floor. Use it only to take the registry
version before you have moved your layouts, and remove it when you have. See
the Bundu floor.
In an app: the CLI
@nyuchi/mzizi-cli adds mzizi check [path...]. It reads the values written in your source and
does not resolve var() or calc(). Version 0.8.0 checks against the earlier 14px and 7px numbers,
and the layer values follow the layer-aware checker.
-file form that covers the whole file.
Sources
The owner’s ruling of 19 November 2026 sets these values, with a second ruling the same day on the dense step and the pill and chip tokens.--space-label-gap (7, dense 5) and the sibling-item rule
were derived from the number rule, and they are pending the owner’s confirmation. The spec and its specimen are in the owner’s workspace and
are not published here. The earlier floor was tracked in
mzizi-registry#617. The rule and its tests
are in the registry’s
sizes-and-density.md.