Docs ยท Guide

Component library

Reusable patterns implemented with semantic HTML and the shared design system. Prefer these classes over new one-off styles.

Shell

Header / Footer

Mount with data-site-nav and data-site-footer. Implemented once in site.js.

Breadcrumbs

.breadcrumbs with current page aria-current="page".

Global search

Progressive dialog from site.js; corpus in search-index.json.

Product subnav

.product-subnav for in-product section links.

Content

Hero / section header

.section-header and .section-header--start for left-aligned product heroes.

Cards

.card, .card-tag, ecosystem and capability variants.

Buttons

.btn, .btn-primary, .btn-ghost, size modifiers.

Related products

data-related-products="ai,docs" renders registry-backed links.

Feedback

Info alert โ€” use for neutral guidance.
Success alert โ€” confirmations and safe policies.
Warning alert โ€” limits, experimental status, caution.
How should FAQ items be marked up?

Use .faq with details.faq-item so content works without JavaScript and remains keyboard accessible.

Do components require a framework?

No. They are plain HTML + CSS with optional progressive JS enhancement.

Docs UI

.docs-layout, .docs-sidebar, .docs-nav, .docs-content, and .code-block support long-form documentation.

Catalog cards

Download card

Checklist example

Use for Downloads catalog entries with format, license, and CTA.

Tool card

Prototype example

Use for Labs prototypes and AI tool summaries.

Service card

Device guidance

Use for Device Service categories and intake paths.

Back to Docs Component notes (markdown)