Foundry product model Review the system vocabulary and the relationship between reusable Foundry layers. v0.2.2 docs current site-builderscore-developersintegratorsai-agents
v0.2.2 docs current Public

Foundry product model

Review the system vocabulary and the relationship between reusable Foundry layers.

Owner
Foundry product documentation
Source
docs/docs/SYSTEM-SPEC.md
Ref
v0.1.4
Policy
release-bound
Component pins for v0.2.2
ComponentRoleVersion
coreruntimev0.1.16
theme-shieldthemev0.1.15
restricted-component-1brand-themev0.1.5
dark-moderuntime-addonv0.1.0
i18nruntime-addonv0.1.0
starterreferencev0.1.3
docsreferencev0.1.4
distributiontoolingv0.3.1
restricted-component-2consumer-referencev0.1.5
restricted-component-3consumer-referencev1.1.21

Content Contract

Each page defines a sections array. Each item must include:

  • block key
  • content payload Optional: id, design

Renderer

render-sections.html resolves each block via site.Data.foundry["block-registry"]. Unknown block keys are warned at build time.

UI Primitives

  • site.Data.foundry.classes defines shared tokens (card, panel, chip, badge).
  • components/button.html defines button variants.

Variants

Variants live in design.variant and must be documented in BLOCKS.md.

Data-driven Sections

Blocks may reference shared data using data (string or map). Section values override data values.

  • Build: hugo --minify
  • Registry validation: no unknown block keys in content
  • Schema validation: required block keys exist (see data/foundry/block-schemas.json)
  • Version pinning for site safety

Static Pagefind search

Search Foundry documentation

Type at least two characters
Search the full documentation system

Results stay inside this build profile and can be filtered by version, component, audience, and lifecycle.