Layout

Site shell

The public site uses shared layout pieces for the header, footer, and route framing. Edit those pieces when the change needs to apply across the site, not when you are only tuning one page.

Docs shell

The docs route has its own shell because it needs search, navigation, a narrow reading column, and an optional right rail. Keep docs-specific concerns in src/docs/_components/*, and keep generic layout concerns in src/components/layout/*.

Composition rules

• Prefer shared layout updates over one-off page wrappers when the behavior is global.
• Keep the docs shell practical and quiet; it should help people complete tasks, not sell itself.
• If a layout change only exists to support one page, keep it local to that page first.