Bundu standards

The Bundu floor

Version 1.1.0, adopted. The owner set these values on 2026-11-19. Licence: CC BY 4.0 for the text, CC0 for floor.json, which holds every value below as data.

The Bundu floor is the set of minimums no screen in the ecosystem can go under: how large a control is to hit, how large text is, how much contrast it has, and how much space sits around each layer of a screen. It is the seventh of the ecosystem's engineering constraints (bundu-floor).

Mzizi implements it: its token layer applies these values by default, and its tests, component contracts and mzizi check fail a build that goes under one. Mzizi is a Bundu Foundation project, built by Nyuchi; Nyuchi runs its cyber section. This page is where the floor's text is published.

Who the floor serves

Every screen built on the floor is readable in the sun and usable with one thumb, because the system will not let it be anything less.

The number rule

Every length in the floor is a multiple of 3, a multiple of 7, or a prime.

  1. Start from the recommended value: WCAG 2.2, Apple's Human Interface Guidelines or Material 3.
  2. Take the nearest allowed value at or above it, never below it. So WCAG's 44 becomes 45 (3 × 15), and Material's 8 becomes 9 (3 × 3).
  3. Cards, containers and page layout step on the seven: 7, 14, 21, 28, 49. The one exception is the page edge on phones, which takes the general rule: 17, the next allowed value at or above 16.

Hit area

WhereFloorBuilt fromRecommendedSource
Touch: a coarse pointer, or any window under 64rem45 × 453 × 1544WCAG 2.2 SC 2.5.5 Target Size (Enhanced), AAA; Apple 44pt
Fine pointer: a fine pointer with hover, 64rem and wider24 × 243 × 824WCAG 2.2 SC 2.5.8 Target Size (Minimum), AA

The fine-pointer tier is the media query (pointer: fine) and (hover: hover) and (min-width: 64rem) and (not (any-pointer: coarse)). Every other screen is touch. Dense controls keep the full hit area in both tiers.

Control heights

Control heightFloorBuilt from
Small333 × 11
Large41prime

Both were off the number rule before 2026-11-19 (32 and 40) and take the nearest allowed value at or above. A small touch target that was 40 is 41 as well.

Text, contrast and leading

RequirementFloorStandard
Body text17px on touch, 15px on a fine pointerApple's default body size is 17pt
Captions and secondary labels14px
Body text contrast7:1WCAG 2.2 SC 1.4.6 Contrast (Enhanced), AAA
Text that is not body text4.5:1WCAG 2.2 SC 1.4.3 Contrast (Minimum), AA
Interface parts (borders, icons, focus, control states)3:1WCAG 2.2 SC 1.4.11 Non-text Contrast, AA
Body leading1.5, as the defaultWCAG 2.2 SC 1.4.12 Text Spacing, AA

Spacing, layer by layer

Each layer of a screen has its own spacing, and each has two values. The default value is the floor at default density. The dense value is the absolute floor: nothing goes under it. A component may go larger than either, never smaller, and no brand pack or density setting can lower one.

Use the default for reading, forms, onboarding, payments, and anything someone does once and must get right. Use dense for tables, data views, toolbars, filter rows, status pills, and lists people scan.

LayerValueDefaultDenseRecommended (default / dense)Source of the recommendation
PillsSide padding958 / 4A compact status pill; Material 3 large badge 4dp
PillsDot or icon to label534 / 2
ChipsSide padding12912 / 8Material 3 chip (8dp compact)
ControlsButton side padding171216 / 12Material 3 button (12dp dense)
ControlsField side padding171216 / 12Material 3 text field
ControlsIcon to label978 / 6Material 3 icon to label
ControlsBetween controls998 / 8Material 3 spacing between targets
ControlsLabel to field754 / 4Material 3 label to field
CardsPadding211416 / 12Material 3 card (12dp list item)
CardsTitle to body774 / 4The Material 3 4dp step
CardsBetween cards1478 / 4Material 3 space between cards
ListsBetween list items1478 / 4Material 3 list items; the card gap
ContainersPadding (dialogs, sheets, panels)282124 / 16Material 3 dialog (16dp sheet)
ContainersGap between their parts211416 / 12Material 3 dialog content spacing
PageEdge on phones171716Apple layout margin 16pt; Material 3 compact 16dp
PageEdge on wide screens282124 / 16 to 24Material 3 medium and expanded windows, 24dp
PageBetween sections492848 / 24The common 48px section rhythm

The phone page edge has no dense step. Controls, cards, containers and pages are nested: a container holds cards, and a card holds controls, so each layer steps up from the one inside it.

Floor against floor

How the Bundu floor compares with WCAG 2.2, Apple's Human Interface Guidelines, Material 3 and Anthropic's brand guidelines, as read on 2026-11-19. The Bundu floor enforces each value; the others mostly recommend.

RequirementBundu floorWCAG 2.2Apple HIGMaterial 3Anthropic brand
Touch target45 × 45px, enforced44 × 44px (2.5.5, AAA)44 × 44pt, recommended48 × 48dp, recommendedNot set: a visual identity, not a UI system
Fine-pointer target24 × 24px, enforced24 × 24px, or enough spacing (2.5.8, AA)28pt macOS control height, a conventionNot separate: 48dp everywhereNot set
Body text17px touch, 15px fine pointer; captions 14pxNo size; text resizes to 200% (1.4.4)17pt default body; captions 12 and 11ptBody Large 16sp, Body Medium 14spLora body, Poppins headings
Body contrast7:1, enforced4.5:1 at AA (1.4.3), 7:1 at AAA (1.4.6)4.5:1 for custom colours4.5:1; 3:1 for large textNot a rule
Interface parts3:1, enforced3:1 (1.4.11, AA)Covered by system materials3:1Not set
Line height1.5 body, the defaultContent survives 1.5 (1.4.12, AA)About 1.29 (17pt on 22pt)1.5 (Body Large, 16 on 24sp)Not set
SpacingA floor per layer, default and denseOnly through 2.5.8 spacing and 1.4.12Layout margins and safe areas8dp grid, 4dp for small partsNot set
Who can lower itNo oneA page meets the level or it does notEach app (guidelines, App Review)Each app (guidelines)Not set

Anthropic's palette against the floor

Anthropic's guidelines name colours and typefaces but set no accessibility rules. Each colour, measured with the WCAG 2 contrast formula against the brand's own Light (#faf9f5) and Dark (#141413) grounds:

ColourOn LightOn Dark
Orange #d977572.96:15.90:1
Blue #6a9bcc2.78:16.30:1
Green #788c5d3.49:15.01:1
Mid Gray #b0aea52.11:18.29:1
Dark #141413 on Light17.50:1n/a

On Light, no accent is legible as text; on Dark, the accents reach 4.5:1 but not the 7:1 body floor. That fits how Anthropic uses the palette: accents for shapes, running text in Dark on Light. The Bundu floor makes the same split explicit and testable.

Where the floor stands

What changed on 2026-11-19

Sources

Files

The source of these files, with their tests, is standards/bundu-floor/ on GitHub.