Skip to content

Patterns

Every Nyuchi ecosystem app follows these patterns. They are not optional — they ensure consistency, resilience, and maintainability across all 17 mukoko mini-apps and 7 nyuchi enterprise products. Each pattern is tested against the four pillars: sovereignty, resilience, accessibility, and African-first infrastructure.

5-Layer Architecture

Mandatory layered component architecture that enforces separation of concerns from primitives to server pages.

Read more →

Component Patterns

CVA variants, Radix UI primitives, cn() composition, and data attributes — the mandatory stack for every component.

Read more →

Error Boundaries

Three layers of error isolation that prevent one failing section from crashing the entire page.

Read more →

Observability

Structured logging, performance measurement, and error tracking with the [mukoko] prefix for grep-ability.

Read more →

Lazy Loading

Sequential mounting — one section at a time through a FIFO queue, with memory pressure monitoring.

Read more →

Mobile-First

Designing for constrained bandwidth and lower-end hardware as the primary use case.

Read more →

Dashboard

Composing stats, charts, sidebars, and data tables into a consistent dashboard layout.

Read more →

Authentication

Sign in, sign up, and password reset flows with form validation.

Read more →

Resource Index

List views with filtering, sorting, and pagination for collections of resources.

Read more →

Resource Detail

Detail views for a single resource, with related actions and metadata.

Read more →

These patterns are enforced across all 17 mukoko mini-apps operating in three modes — musha (home), basa (work), nhaka (heritage) — and all 7 nyuchi enterprise products including weather, news, events, and shamwari. Install components from this registry — do not copy-paste or create parallel libraries.