Skip to content

Architecture

The Mzizi design system is structured as a 3D architecture model: ten ecosystem nodes arranged across five axes. Every component sits at exactly one position in this model, and the placement determines what it may import, what it must do, and how it is observed.

Mzizi is a programming language (research, Phase 0), a design system, a component registry, a CLI toolchain, and skills for web and server architecture. Mzizi is a Bundu Foundation project, built by Nyuchi; Nyuchi runs its cyber section.

Axis Geometry What it covers
X-axis Horizontal composition What the user sees — L2 primitives, L3 brand, L6 pages, L7 shell
Y-axis Vertical infrastructure What flows through everything — L1 tokens, L4 safety, L5 resilience
Z-axis Depth observation What watches the system — L8 assurance
Outside Setup agent What helps consumers wire the system in — N9 fundi
Documentation Self-description The system describing itself — N10
# Node Axis Covenant
1 Tokens Y Design decisions are data, not code.
2 Primitives X A primitive does one thing well.
3 Brand X A brand component is a primitive with Ubuntu in it.
4 Safety Y Nothing harmful reaches the user.
5 Resilience Y Failure in one part never breaks the whole.
6 Pages X A page is a composition, not an implementation.
7 Shell X The shell holds the product.
8 Assurance Z What breaks is seen before users feel it.
9 Fundi Outside Setup is a guided agent loop, not a manual checklist.
10 Documentation Documentation The system documents itself in code.
  • Components import from the node below on the same axis — never sideways or upward.
  • Each component is a standalone, independently installable file.
  • N6 pages never hardcode buttons, cards, or SVGs — they are pure compositions of N2/N3.
  • N1 is the only node allowed to define CSS values; every other node consumes them via var().
  • N3 components always destructure { log, motion, LiveRegion } from useNyuchiHarness; N2 never imports it.

Node Decision Guide

How to decide which of the 10 ecosystem nodes a component belongs to.

Read more →

Component Backlinks

The stable URL graph that ties every component to its docs, source, and health.

Read more →

Fundi

The agent inside mzizi-sdk that helps consumers set up Mzizi in their project.

Read more →

Registry

The shadcn-compatible registry that serves the design system.

Read more →