Skip to content

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.

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).

  • 200 — component exists and is stable
  • 404 — component does not exist
  • 410 — component exists but is deprecated (reserved; the components table has no status enum yet)
  • 503 — Supabase unconfigured (operator action required)
  • 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 portal
  • 404 / 503 — same as above

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
-- Get all links for a component
SELECT * FROM get_component_links('nyuchi-section');
-- Query all components with backlinks
SELECT * FROM component_backlinks;