Home Grid

Wiki-origin componentUpdated 2 weeks ago

Live preview

populated

empty

Components
2 variants Tokens-backed WCAG 2.2 AA target

9-card responsive category-browse grid for the documentation wiki home page. Always renders all 9 ratified categories regardless of article count — an empty category reads as "in preparation," never as a missing page.

Rendered from components/home-grid/recipe.json

When to use Home Grid

Use Home Grid as the category-browse entry point on a documentation wiki's home page — a 9-card grid, one card per ratified content category, each showing an article count and a short preview list. It is the front door to the wiki, not a general-purpose card grid.

The 9-category set

The category set is closed and operator-ratified (per naming-convention.md §10 Q5-A): Architecture, Services, Systems, Applications, Governance, Infrastructure, Company, Reference, Help. Do not alphabetize or reorder this list, and do not suppress empty categories — every deployment renders all 9, always. An empty category shows 0 articles — in preparation rather than being hidden, so a visitor never wonders whether a category exists.

Variants

VariantShows
PopulatedArticle count, top-3 child links, a More → link to the full category.
Empty0 articles — in preparation only — no child list, no More link.

Layout

3 columns at ≥960px, 2 columns from 640–959px, 1 column below 640px.

Behaviour

Each card has a hover border-color transition (collapses under prefers-reduced-motion). Card titles and child links carry a :focus-visible ring. Heading hierarchy: h2 for the section heading ("Browse by category"), h3 per card title — screen readers get one section landmark via aria-label, not a redundant visible heading duplicate.

When not to use

This is not a generic content card grid — it is specifically the 9-category wiki home-page browse surface. For a general card layout elsewhere on the site, use the substrate's generic .card/.card-grid classes instead.

Important Information

Design System disclosure

This site provides open-source design tokens, documentation, and self-hostable software published by Woodfine Capital Projects Inc. Information here is for general reference only and does not constitute an offer, warranty, or a guarantee of fitness for any particular purpose. Statements regarding planned, intended, or targeted future features are forward-looking and subject to change without notice; they are not undertaken to be updated except as required by law.