ChartGPU

ChartGPU/ChartGPU: Beautiful, open source, WebGPU-based charting library

by

chartgpu

High-performance charts powered by WebGPU

Documentation Live Demo | Example

npm

license

live demo

ChartGPU is a TypeScript charting library built on WebGPU for smooth, interactive rendering – especially when you have a lot of data.

  • 🚀 WebGPU-accelerated rendering for high FPS with large datasets
  • 📈 Multiple series types: Line, Area, Bar, Scatter, Pie, Candlestick
  • 🧭 Built-in interactions: hover highlight, tooltip, crosshairs
  • 🔁Via streaming updates appendData(...) (Cartesian series)
  • 🔍 X-axis zoom (inside gestures + optional slider UI)
  • 🎛️ Theme presets ('dark' | 'light') and custom theme support

at high level, ChartGPU.create(...) Canvas + WebGPU owns the lifecycle, and submits the orchestration (layout/scale/data upload/render passes + internal overlays) to the render coordinator. For in-depth internal notes, see docs/API.md (Especially “Render Coordinator”).

Coordinator End Subgraph WebGPUCore[“WebGPU core (src/core/GPUContext.ts)”]
GPUInit -> AdapterDevice[“navigator.gpu.requestAdapter/device”]
GPUInit –> CanvasConfig[“canvasContext.configure(format)”]
End Subgraph RenderCoordinatorLayer[“Render coordinator (src/core/createRenderCoordinator.ts)”]
Coordinator –> Layout[“GridArea layout”]
coordinator –> scales[“xScale/yScale (clip space for render)”]
Coordinator–>Dataupload[“createDataStore(device) (GPU buffer upload/caching)”]
coordinator –> renderpass[“Encode + submit render pass”]

subgraph internaloverlays[“Internal interaction overlays (coordinator)”]
Coordinator –> Events[“createEventManager(canvas, gridArea)”]
Events -> OverlayHitTest[“hover/tooltip hit-testing”]
Events -> Interactions[“interaction-x state (crosshair)”]
Coordinator –> OverlayDOM[“DOM overlays: legend / tooltip / text labels”]
end end subgraph renderers[“GPU renderers (src/renderers/*)”]
renderpass -> gridR[“Grid”]
renderpass -> areaR[“Area”]
renderpass -> barR[“Bar”]
renderpass -> scatterR[“Scatter”]
renderpass -> lineR[“Line”]
renderpass -> peer[“Pie”]
RenderPass -> CandlestickR[“Candlestick”]
renderpass -> crosshairR[“Crosshair overlay”]
renderpass -> highlightR[“Hover highlight overlay”]
renderpass -> axisR[“Axes/ticks”]
end subgraph shaders[“WGSL shaders (src/shaders/*)”]
GridR -> GridWGSL[“grid.wgsl”]
AreaR -> AreaWGSL[“area.wgsl”]
barR –> barWGSL[“bar.wgsl”]
ScatterR -> ScatterWGSL[“scatter.wgsl”]
lineR -> lineWGSL[“line.wgsl”]
PIR -> PiWGSL[“pie.wgsl”]
CandlestickR -> CandlestickWGSL[“candlestick.wgsl”]
CrosshairR -> CrosshairWGSL[“crosshair.wgsl”]
highlightR -> highlightWGSL[“highlight.wgsl”]
end subgraph chartsync[“Chart sync (src/interaction/createChartSync.ts)”]
SyncAPI -> ListenX[“listen: ‘crosshairMove'”]
SyncAPI –> DriveX[“setCrosshairX(…) on peers”]
end interactionX –> listenX driveX –> instanceAPI ” dir=’auto’>

flowchart TB
  UserApp["Consumer app"] --> PublicAPI["src/index.ts (Public API exports)"]

  PublicAPI --> ChartCreate["ChartGPU.create(container, options)"]
  PublicAPI --> SyncAPI["connectCharts(charts)"]

  subgraph ChartInstance["Chart instance (src/ChartGPU.ts)"]
    ChartCreate --> SupportCheck["checkWebGPUSupport()"]
    ChartCreate --> Canvas["Create canvas + mount into container"]
    ChartCreate --> Options["resolveOptions(options)"]
    ChartCreate --> GPUInit["GPUContext.create(canvas)"]
    ChartCreate --> Coordinator["createRenderCoordinator(gpuContext, resolvedOptions)"]

    ChartCreate --> InstanceAPI["ChartGPUInstance APIs"]
    InstanceAPI --> RequestRender["requestAnimationFrame (coalesced)"]
    RequestRender --> Coordinator

    InstanceAPI --> SetOption["setOption(...)"]
    InstanceAPI --> AppendData["appendData(...)"]
    InstanceAPI --> Resize["resize()"]

    subgraph PublicEvents["Public events + hit-testing (ChartGPU.ts)"]
      Canvas --> PointerHandlers["Pointer listeners"]
      PointerHandlers --> PublicHitTest["findNearestPoint() / findPieSlice()"]
      PointerHandlers --> EmitEvents["emit('click"https://github.com/"mouseover"https://github.com/"mouseout')"]
    end

    DataZoomSlider["dataZoom slider UI (DOM)"] --> Coordinator
  end

  subgraph WebGPUCore["WebGPU core (src/core/GPUContext.ts)"]
    GPUInit --> AdapterDevice["navigator.gpu.requestAdapter/device"]
    GPUInit --> CanvasConfig["canvasContext.configure(format)"]
  end

  subgraph RenderCoordinatorLayer["Render coordinator (src/core/createRenderCoordinator.ts)"]
    Coordinator --> Layout["GridArea layout"]
    Coordinator --> Scales["xScale/yScale (clip space for render)"]
    Coordinator --> DataUpload["createDataStore(device) (GPU buffer upload/caching)"]
    Coordinator --> RenderPass["Encode + submit render pass"]

    subgraph InternalOverlays["Internal interaction overlays (coordinator)"]
      Coordinator --> Events["createEventManager(canvas, gridArea)"]
      Events --> OverlayHitTest["hover/tooltip hit-testing"]
      Events --> InteractionX["interaction-x state (crosshair)"]
      Coordinator --> OverlaysDOM["DOM overlays: legend / tooltip / text labels"]
    end
  end

  subgraph Renderers["GPU renderers (src/renderers/*)"]
    RenderPass --> GridR["Grid"]
    RenderPass --> AreaR["Area"]
    RenderPass --> BarR["Bar"]
    RenderPass --> ScatterR["Scatter"]
    RenderPass --> LineR["Line"]
    RenderPass --> PieR["Pie"]
    RenderPass --> CandlestickR["Candlestick"]
    RenderPass --> CrosshairR["Crosshair overlay"]
    RenderPass --> HighlightR["Hover highlight overlay"]
    RenderPass --> AxisR["Axes/ticks"]
  end

  subgraph Shaders["WGSL shaders (src/shaders/*)"]
    GridR --> gridWGSL["grid.wgsl"]
    AreaR --> areaWGSL["area.wgsl"]
    BarR --> barWGSL["bar.wgsl"]
    ScatterR --> scatterWGSL["scatter.wgsl"]
    LineR --> lineWGSL["line.wgsl"]
    PieR --> pieWGSL["pie.wgsl"]
    CandlestickR --> candlestickWGSL["candlestick.wgsl"]
    CrosshairR --> crosshairWGSL["crosshair.wgsl"]
    HighlightR --> highlightWGSL["highlight.wgsl"]
  end

  subgraph ChartSync["Chart sync (src/interaction/createChartSync.ts)"]
    SyncAPI --> ListenX["listen: 'crosshairMove'"]
    SyncAPI --> DriveX["setCrosshairX(...) on peers"]
  end

  InteractionX --> ListenX
  DriveX --> InstanceAPI



It’s loading


chartgpu demo

Financial OHLC (Open-High-Low-Close) candlestick rendering with classic/hollow style toggle and color customization.

candlestick chart example

import { ChartGPU } from 'chartgpu';
const container = document.getElementById('chart')!;
await ChartGPU.create(container, {
  series: [{ type: 'line', data: [[0, 1], [1, 3], [2, 2]] }],
});

npm install chartgpu

Available via React bindings chartgpu-react: :

npm install chartgpu-react
import { ChartGPUChart } from 'chartgpu-react';

function MyChart() {
  return (
    <ChartGPUChart
      options={{
        series: [{ type: 'line', data: [[0, 1], [1, 3], [2, 2]] }],
      }}
    />
  );
}

See the chartgpu-react repository for complete documentation and examples.

Browser support (WebGPU required)

  • Chrome 113+ or Edge 113+ (WebGPU enabled by default)
  • Safari 18+ (WebGPU enabled by default)
  • Firefox: not supported (WebGPU support in development)
  • Browse examples: examples/
  • Run locally:
    • npm install
    • npm run dev (opens http://localhost:5176/examples/)

Look CONTRIBUTING.md.

mit-see LICENSE.



<a href

Leave a Comment