Skip to main content
This section documents Mzizi’s components: the registry and design system that support the language, served through api.mzizi.dev and browsable at mzizi.dev/components. It is not documentation for the language itself; the ecosystem page draws the line. Rust components (Mzizi Roots) lead. The React and TypeScript code on these pages is the React build: it keeps working, but it is deprioritised and not where new work goes.
Blocks are compositions of registry components at a higher level than a single component. A button is a component; a complete sign-in screen is a block.

​
How blocks work

Blocks are composed entirely from registry components, following the application layers — domain composites built from shared primitives. The registry publishes 105 items of type registry:block, so many blocks are directly installable. The pages in this section document the composition patterns behind the common ones, which is what you need when you are building a variant rather than taking the default.

​
Available patterns

Dashboard

Stats, charts, sidebar layout and data tables.

Authentication

Sign in, sign up and password reset.

Sidebar

Collapsible sidebar with navigation groups and a user menu.

​
Building with a block

  1. Install the components the block needs from the registry.
  2. Follow the composition pattern.
  3. Replace the content and data with your own.
  4. The block inherits your token layer automatically — it references semantic tokens, not values.
Step four is the reason these are patterns rather than screenshots: the same composition looks like your product because none of it names a colour.