Deprecated guidance Use the replacement document where one is available.
v0.2.5 docs deprecated Public

Bricks and reusable composition

Understand the earlier composition contract and how it relates to current Foundry layers.

Owner
Foundry product documentation
Source
docs/docs/BRICKS.md
Ref
v0.1.4
Policy
release-bound
Component pins for v0.2.5
ComponentRoleVersion
coreruntimev0.1.21
theme-shieldthemev0.1.15
starterreferencev0.1.3
docsreferencev0.1.4
distributiontoolingv0.3.3
restricted-component-1consumer-referencev0.1.10
restricted-component-2consumer-referencev1.1.21

Foundry supports an alternate “bricks” structure:

bricks:
  hero:
    block: hero
    content: ...
  stats:
    block: stats-grid
    content: ...
bricks_order:
  - hero
  - stats

If sections is empty and bricks exists, Foundry will render bricks in bricks_order (or map order if not provided).

Use this when you want reusable named blocks and ordering without duplicating section objects.

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.