Generated Charts

Generate

CLI & API Reference

Two ways to generate on-brand Dealroom charts programmatically — both use the same chart contract and template engine as this Config Studio.

CLI — dealroom-chart.mjs

The CLI lives at cli/dealroom-chart.mjs in the repo. It reads the chart contract locally and outputs standalone HTML — no server needed.

# List all available chart types
node cli/dealroom-chart.mjs types

# Get an example spec to modify
node cli/dealroom-chart.mjs spec-example stackedBar > spec.json

# Generate chart and open in browser
node cli/dealroom-chart.mjs create --spec spec.json -o chart.html --open

# Pipe from another tool
cat spec.json | node cli/dealroom-chart.mjs create -o chart.html

# Print the chart contract (design tokens)
node cli/dealroom-chart.mjs contract

# Print as AI-readable prompt (for LLM workflows)
node cli/dealroom-chart.mjs contract --prompt

The CLI supports all 21 chart types: bar, horizontalBar, line, stepLine, stackedBar, percentStackedBar, doughnut, groupedBar, multiLine, areaChart, stackedArea, horizontalStackedBar, pie, radar, waterfall, scatter, boxPlot, geoMap, choropleth, cartogram, marketMap.

API — POST /api/create-chart

The HTTP API accepts a chart spec as JSON and returns standalone HTML. It runs on Cloudflare Workers and reads the same chart contract from KV storage.

# Generate a stacked bar chart via the API
curl -X POST https://dealroom.co/api/create-chart \
  -H "Content-Type: application/json" \
  -d '{
    "chartType": "stackedBar",
    "headline": "VC funding by stage",
    "subtitle": "2020–2024, in billions",
    "labels": ["2020", "2021", "2022", "2023", "2024"],
    "datasets": [
      { "label": "Seed", "data": [8, 12, 10, 9, 11] },
      { "label": "Series A", "data": [15, 22, 18, 14, 17] },
      { "label": "Series B+", "data": [30, 55, 40, 28, 35] }
    ],
    "unit": "$B",
    "source": "Dealroom.co",
    "theme": "light"
  }' -o chart.html

# Get API documentation and examples
curl https://dealroom.co/api/create-chart

The API returns the HTML directly. Default theme is light. Add "theme": "dark" for dark mode.

Chart Spec Format

Both the CLI and API accept the same JSON spec. Required fields depend on chart type:

Map Chart Specs

Map types (geoMap, choropleth, cartogram) use D3.js + TopoJSON instead of Chart.js. They don't use labels/datasets — each has its own data format:

# Generate a choropleth via the API
curl -X POST https://dealroom.co/api/create-chart \
  -H "Content-Type: application/json" \
  -d '{
    "chartType": "choropleth",
    "headline": "AI startup density across Europe",
    "subtitle": "Companies per capita, 2026",
    "region": "europe",
    "regions": [
      { "id": "826", "label": "United Kingdom", "shortLabel": "UK", "value": 95 },
      { "id": "276", "label": "Germany", "shortLabel": "DE", "value": 72 },
      { "id": "250", "label": "France", "shortLabel": "FR", "value": 68 }
    ],
    "source": "Dealroom.co"
  }' -o chart.html

# Generate a cartogram via CLI
node cli/dealroom-chart.mjs spec-example cartogram > spec.json
node cli/dealroom-chart.mjs create --spec spec.json -o chart.html --open

Common ISO country codes: UK=826, US=840, DE=276, FR=250, NL=528, SE=752, ES=724, CH=756, IE=372, IT=380, NO=578, DK=208, FI=246, PL=616, AT=40, BE=56, PT=620, CZ=203.

Market Map Spec

The marketMap type renders a masonry grid of sector cards with company logos. It doesn't use labels/datasets — it uses groups:

# Generate a market map via the API
curl -X POST https://dealroom.co/api/create-chart \
  -H "Content-Type: application/json" \
  -d '{
    "chartType": "marketMap",
    "headline": "European Unicorns by Sector",
    "subtitle": "350+ unicorns across 12 sectors",
    "groups": [
      {
        "name": "Fintech",
        "count": 62,
        "value": "$180B",
        "growth": "+1.8x",
        "companies": [
          { "name": "Revolut", "logo": "revolut.com" },
          { "name": "Klarna", "logo": "klarna.com" },
          { "name": "N26", "logo": "n26.com" }
        ]
      },
      {
        "name": "AI",
        "count": 48,
        "value": "$120B",
        "growth": "+3.6x",
        "companies": [
          { "name": "Mistral AI", "logo": "mistral.ai" },
          { "name": "DeepL", "logo": "deepl.com" }
        ]
      }
    ]
  }' -o chart.html

# Via CLI
node cli/dealroom-chart.mjs spec-example marketMap > spec.json
node cli/dealroom-chart.mjs create --spec spec.json -o chart.html --open

Company logos are fetched from Google Favicons using the domain name. If the logo fails to load, a colored initial is shown as fallback.

Workflow: Using the CLI with AI Agents

The CLI is designed to work with AI coding agents (Claude Code, Cursor, etc.). The recommended workflow:

1. Get the contract — run node cli/dealroom-chart.mjs contract --prompt to get the full design system as an AI-readable prompt.
2. Create a spec — write a JSON file with your data, or start from an example: node cli/dealroom-chart.mjs spec-example stackedBar
3. Generate — run node cli/dealroom-chart.mjs create --spec spec.json -o charts/my-chart.html --open
4. Add to /resources — add a chart entry to the charts array in resources.html

The CLI uses the same generateChartHtml() function and chart contract as this Config Studio — design tokens, colors, typography, logo sizing, and direct labels all come from the same source of truth.

SVG Logos

All SVG logos available in the chart system. Logos marked NEEDS IMPROVEMENT are approximated and should be replaced with official assets.

Core — Dealroom

Partner Logos (co-branding)

Used via coBranding: [{ name: "waldenCatalyst" }] in the chart spec.

Inline / Embedded

Logos embedded directly in chart template source code.