Component Backlinks
Every component in the design system has a stable set of canonical URLs on mzizi.dev. The portal page, JSON API, source view, version history, per-component health probe, and chaos manifest are all live — every URL below resolves for any registry component name.
URL Structure
Section titled “URL Structure”| Endpoint | URL Pattern | Purpose |
|---|---|---|
| Portal | mzizi.dev/components/{name} | Documentation page |
| Source | mzizi.dev/source/{name} | Full TypeScript source view |
| Changelog | mzizi.dev/changelog/{name} | Per-component version history |
| API (component) | mzizi.dev/api/v1/ui/{name} | Component metadata + source (shadcn-format) |
| API (docs) | mzizi.dev/api/v1/ui/{name}/docs | Use cases, variants, a11y notes |
| API (versions) | mzizi.dev/api/v1/ui/{name}/versions | Per-component version JSON |
| Health | mzizi.dev/api/health/{name} | Per-component health probe (200/404/410/503) |
| Chaos | mzizi.dev/api/chaos/{name} | Chaos-fault manifest (GET; POST is 405 by design) |
The site-wide health probe lives at /api/v1/health. Use the per-component URLs above when you have a target component name (and the URLs in any rendered data-portal attribute).
Status semantics for /api/health/{name}
Section titled “Status semantics for /api/health/{name}”200— component exists and is stable404— component does not exist410— component exists but is deprecated (reserved; thecomponentstable has no status enum yet)503— Supabase unconfigured (operator action required)
Status semantics for /api/chaos/{name}
Section titled “Status semantics for /api/chaos/{name}”GET 200— returns the supported-fault manifest for this component (render-error, slow-render, missing-data, network-timeout)POST 405— chaos injection is in-process by design; install the L8 chaos lib in your app rather than hitting the portal404/503— same as above
DOM Integration
Section titled “DOM Integration”Every rendered component includes a data-portal attribute pointing at its live portal page:
<div data-slot="nyuchi-section" data-portal="https://mzizi.dev/components/nyuchi-section">This allows:
- DevTools inspection to click through to component docs
- Error tracking to enrich errors with portal links
- N8 chaos testing to look up the supported-fault manifest by stable URL
- The N9 Fundi agent (in
mzizi-sdk) to resolve a rendered component back to its canonical documentation
Database
Section titled “Database”-- Get all links for a componentSELECT * FROM get_component_links('nyuchi-section');
-- Query all components with backlinksSELECT * FROM component_backlinks;