concept-diagrams

Concept Diagrams

Overview

Generate production-quality SVG diagrams with a unified flat, minimal design system. Output is a single self-contained HTML file that renders identically in any modern browser, with automatic light/dark mode.

Scope

Best suited for:

• Physics setups, chemistry mechanisms, math curves, biology
• Physical objects (aircraft, turbines, smartphones, mechanical watches)
• Anatomy, cross-sections, exploded layer views
• Floor plans, architectural conversions
• Narrative journeys (lifecycle of X, process of Y)
• Hub-spoke system integrations (smart city, IoT)
• Educational / textbook-style visuals in any domain

Look elsewhere first for:

• Software/cloud architecture with dark tech aesthetic → use architecture-diagram
• Hand-drawn whiteboard sketches → use an excalidraw-style tool

Workflow

1. Decide on the diagram type (see below)
2. Lay out components using the Design System rules
3. Write the full HTML page with inline SVG + CSS
4. Save as a standalone .html file via write_file
5. User opens it directly in a browser — no server, no dependencies

write_file("diagram.html", "<full HTML with inline SVG + CSS>")

Diagram Types

Type	When
Process flow	Sequential steps, lifecycle, pipeline
Hub-spoke	Central system + connected components (IoT, smart city)
Exploded layers	Component breakdown, cross-section
Comparison	Side-by-side, before/after
Cycle	Circular process, feedback loop
Hierarchy	Org chart, taxonomy, tree
Timeline	Chronological events

Design System

Philosophy

• Flat, minimal, no 3D effects
• Semantic colors: 9 color ramps for different element types
• Sentence-case typography: not Title Case
• Automatic dark mode: CSS prefers-color-scheme

Color Ramps (light/dark aware)

:root {
  /* Primary elements */
  --c-primary: #4A90D9;
  --c-secondary: #50C878;
  --c-accent: #F5A623;

  /* Semantic */
  --c-input: #7B68EE;
  --c-output: #FF6B6B;
  --c-process: #4ECDC4;
  --c-data: #95E1D3;
  --c-control: #C4A7E7;
  --c-external: #DDD;

  /* Light mode (default) */
  --bg: #FAFAFA;
  --text: #333;
  --border: #E0E0E0;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #1A1A2E;
    --text: #EEE;
    --border: #333;
    --c-external: #444;
  }
}