Node Decision Guide
How to decide which of the 10 ecosystem nodes a component belongs to.
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. |
var().{ 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.
Component Backlinks
The stable URL graph that ties every component to its docs, source, and health.
Fundi
The agent inside mzizi-sdk that helps consumers set up Mzizi in their project.
Registry
The shadcn-compatible registry that serves the design system.