Why constrained components work

Each component solves a recognizable communication problem and owns its responsive behavior.

  • Reviewable

    The complete page contract remains ordinary, readable YAML.

  • Deterministic

    A valid plan compiles without another round of visual inference.

  • Responsive

    Components choose sensible stacking and wrapping behavior.

  • Theme-aware

    Semantic tokens preserve each theme's personality.

- type: feature-grid
  heading: Why constrained components work
  intro: Each component solves a recognizable communication problem.
  items:
    - { title: Reviewable, text: The page contract remains ordinary YAML. }
    - { title: Deterministic, text: Valid plans compile without visual inference. }
    - { title: Responsive, text: Components own their stacking behavior. }
    - { title: Theme-aware, text: Semantic tokens preserve theme personality. }

Deliberate limits

Features or facts
2-6
Enough range for a useful group without an endless wall.
Actions
1-2
A primary step and, when needed, one alternative.
Column controls
0
Responsive layout remains component-owned.
- type: key-facts
  heading: Deliberate limits
  items:
    - { value: "2-6", label: Features or facts }
    - { value: "1-2", label: Actions }
    - { value: "0", label: Column controls }

The foundational gallery component remains useful when a page needs a straightforward collection of captioned images.