Files
diagram-design/references/type-nested.md
T
Cathryn Lavery 53bd8dde0f Initial release: diagram-design v1.0
Thirteen editorial diagram types (architecture, flowchart, sequence,
state, ER, timeline, swimlane, quadrant, nested, tree, layers, venn,
pyramid) as self-contained HTML files with inline SVG.

Progressive disclosure: lean SKILL.md points to per-type references.
Neutral stone+rust default skin, first-run gate that prompts users
to customize the style guide from their own website, URL-based
onboarding, annotation-callout primitive, sketchy filter variant,
live gallery at assets/index.html.
2026-04-16 13:30:53 -05:00

1.4 KiB
Raw Blame History

Nested Containment

Best for: hierarchy through containment — scope boundaries, CLAUDE.md cascade, trust zones, folder nesting, blast radius. Outer = broader, inner = more specific.

Layout conventions

  • 3–5 rounded rectangles (rx=8), nested with consistent inset padding (24–32px horizontal, 32–36px vertical recommended).
  • Each level labeled at the top-left in Geist Mono eyebrow style (7–8px, letter-spacing 0.14em). Labels sit on a paper-colored mask rect over the ring's top border.
  • Stroke hierarchy: outer rings faint (rgba(..,0.30–0.45)), progressing to muted, to ink, to coral at the innermost focal.
  • Fills step up in opacity from outer to inner: rgba(..,0.015) → rgba(..,0.025) → accent-tint on the innermost.
  • Optional file-icon glyph (folded-corner rect) inside each level hints at scope content.
  • Italic Instrument Serif callouts (see references/primitive-annotation.md) — 1–2 max.

Anti-patterns

  • More than 6 levels (information disappears inward).
  • Irregular padding between levels — unaligned nesting looks accidental.
  • Content inside rings that isn't part of the hierarchy — use a sibling diagram.
  • Coral on multiple levels — hierarchy collapses.

Examples

  • assets/example-nested.html — minimal light
  • assets/example-nested-dark.html — minimal dark
  • assets/example-nested-full.html — full editorial