Design Tokens
CSS custom properties — Five African Minerals, semantic colors, spacing, radius, typography.
Foundations are the bedrock decisions that shape every component and pattern in the Mzizi design system. They define how we handle design tokens, typography, layout, motion, icons, accessibility, and internationalization across all ecosystem apps.
The Mzizi design system is built for the reality of African infrastructure. A user on a 2G connection in a village is not an edge case — that is the primary use case. Every foundation decision is shaped by four architectural pillars:
These pillars translate into concrete constraints:
These are not aspirational goals. They are enforced constraints that shape every component in the registry.
Design Tokens
CSS custom properties — Five African Minerals, semantic colors, spacing, radius, typography.
Typography
Font stack, type scale, and heading hierarchy.
Layout
Responsive breakpoints, spacing scale, and container patterns.
Motion
Animation principles, transitions, and reduced motion.
Icons
Lucide React icon conventions, sizing, and accessibility.
Accessibility
APCA contrast, 45px touch hit areas (24px with a fine pointer), keyboard navigation.
Internationalization
Noto Sans for African languages, RTL support, locale formatting.