nyuchimzizi
Mzizi — an open-architecture project of the Bundu Foundation, operated and developed by Nyuchi. Built on the Five African Minerals palette.
Built by Nyuchi Africav4.0.39
Full app shell composing NyuchiHeader, NyuchiSidebar, and NyuchiBottomNav into a responsive dashboard layout.
No interactive demo is registered for this component yet — the source is shown directly.
"use client"
// ── INFRASTRUCTURE HARNESS (auto-wired) ──────────────────
import { useNyuchiHarness } from "@/lib/harness"
import * as React from "react"
import { cn } from "@/lib/utils"
import { SidebarProvider, SidebarInset } from "@/components/ui/sidebar"
import { NyuchiSidebar, type SidebarSection } from "@/components/nyuchi/nyuchi-sidebar"
import { NyuchiHeader, type NavItem } from "@/components/nyuchi/nyuchi-header"
import { NyuchiBottomNav, type BottomNavItem } from "@/components/nyuchi/nyuchi-bottom-nav"
/* ═══════════════════════════════════════════════════════════════
DASHBOARD LAYOUT — Brand Shell Composition (Enterprise)
The root layout for every ecosystem dashboard/app screen.
Composes sidebar + header + bottom nav + main content area.
✅ L1 TOKENS — Spacing uses design tokens
✅ L2 MOTION — Main content fade-in on route change
✅ L3 A11Y — Main landmark, skip-to-content support
✅ L4 OBSERVABILITY — useNyuchiHarness, page render timing
✅ L5 RESILIENCE — Wraps children, guards missing props
✅ L7 PLATFORM — data-slot for CSS targeting
═══════════════════════════════════════════════════════════════ */
interface DashboardLayoutProps {
appName?: string
sidebarSections: SidebarSection[]
navItems?: NavItem[]
headerActions?: React.ReactNode
bottomNav?: BottomNavItem[]
children: React.ReactNode
className?: string
}
export function DashboardLayout({
appName,
sidebarSections,
navItems,
headerActions,
bottomNav,
children,
loading = false,
className,
}: DashboardLayoutProps) {
// ── L4: HARNESS — Page-level observability ──
const { log, motion, LiveRegion } = useNyuchiHarness("dashboard-layout")
// ── L2: MOTION — Content area fade-in ──
const contentAnimStyle = React.useMemo(() => {
if (motion.prefersReduced) return {}
return {
animation: `nyuchi-fade-slide-up ${motion.enterDuration}ms ${motion.enterEasing} both`,
}
}, [motion])
return (
<SidebarProvider>
{/* L5: RESILIENCE — Guard against undefined sidebarSections */}
<NyuchiSidebar sections={sidebarSections ?? []} appName={appName} collapsible="icon" />
<SidebarInset>
<NyuchiHeader appName={appName} navItems={navItems} actions={headerActions} />
{/* L3: A11Y — Main landmark with skip target */}
<main
id="main-content"
data-slot="dashboard-layout" data-portal="https://design.nyuchi.com/components/dashboard-layout" role="main" aria-label="Dashboard"
className={cn("flex-1 p-4 sm:p-6", className)}
style={contentAnimStyle}
>
{LiveRegion}
{children}
</main>
</SidebarInset>
{/* L5: RESILIENCE — Only render bottom nav if items exist */}
{bottomNav && bottomNav.length > 0 && <NyuchiBottomNav items={bottomNav} />}
</SidebarProvider>
)
}
The variants, sizes, and props surfaced by the registry. Each is sourced from the Supabase component_docs table.
Hit the registry API live and see the JSON the shadcn CLI consumes when it installs this component.
/api/v1/ui/nyuchi-dashboard-layoutnpx shadcn@latest add https://mzizi.dev/api/v1/ui/nyuchi-dashboard-layoutcomponents/mukoko/dashboard-layout.tsx