Skip to main content
The spacing floor is the part of the Bundu floor that sets minimums for space: padding, gaps and the hit regions around them. Each layer of a screen has two values. The default is the floor at default density. The dense value is the absolute floor, and nothing in the layer goes below it, even a component that sets no padding at all. The values are the owner’s ruling of 19 November 2026, with one exception. --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.
  1. Start from the recommended value: WCAG, Apple HIG or Material 3.
  2. Take the nearest Mzizi number at or above it. A little larger is fine. Lower never is.
  3. 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.
Dense controls are drawn smaller, but they keep the full hit area: 45px on touch and 24px on a desktop, through the hit-area pseudo-element. Density changes the visible size, never the target. Dense tokens are named <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 bare button, 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.
A violation that is deliberate carries a comment with a reason, on the same line or the line before:
A comment with no reason is not an exception. The report lists each exception, so a reviewer can see it. The first 20 lines of a file take a -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.