High-performance visualization for every application.
Rekhly Visuals is an independent, original charting engine. It is not a wrapper around another visualization library.
> Millions of data points. Real-time interaction. One visualization platform.
Do not treat any FPS, point-count, or latency figure in this repository as a product claim until it is measured with the published benchmark methodology.
pnpm benchmark
All 13 planned phases (below) are implemented, plus a round of enhancements beyond the original plan:
(persistence "curve" trace and 2D-histogram "colormap"), oscilloscope (free-run/triggered), eye diagram, vector field (quiver) series, on top of the full XY/polar/3D/finance/maps/categorical catalog.
display-line / range / delta; absolute or viewport-relative; FollowY; drag during Sweep Once and Continuously), limit lines with breach detection, detection-bar bands, a legend that can show per-series detail values, a zoom-restore (circle-with-dot) button, and a synchronized ZoomOverview minimap (cyan brush = viewport after zoom — guide).
sticky multi-zoom support) and drag pan. A built-in bottom-center toolbar gives every chart Sweep Once / Sweep Continuously (toggles) / Zoom in / Zoom out for free.
chartXY() component (legend, cursor, markers, limit lines, detection bars, annotations, restore button, toolbar, overview) can be individually enabled/disabled via components, started from a named preset (CHART_PRESETS), reconfigured at runtime (setComponents), or extended with a ChartPlugin — see Configuring components.
See docs/FEATURE_MATRIX.md for the full, per-client capability table (only features with passing tests are marked ✓), and Getting started for the fastest path to a working chart.
Phase 1 establishes the real engine foundation:
pnpm workspaces)initialize / resize / render / dispose@rekhly/core chart entryPhase 2 adds interactive XY charts (rekhly.chartXY): line, scatter, bar, and area series, linear axes, zoom/pan, cursor, and tooltip.
Phase 3 is the GPU optimization layer: pooled DataBuffer storage, zoom-tied LOD (LTTB / envelope / pixel-aware), batched triangle draws, a default-off measured HUD, pnpm benchmark, and pnpm example:large-n. Performance numbers are never claimed without a measurement — see docs/BENCHMARK_METHODOLOGY.md.
Phase 4 adds the advanced 2D surface: textured heatmaps with texSubImage2D partial updates, log/time/category axes, box plots, annotation drag, auto-sync groups, and pnpm example:heatmap / example:stats / example:sync.
Phase 5 is the streaming ingest path: ring buffers, FLXB binary frames, StreamSession backpressure, continuous scroll, pnpm example:sensor, and a long-buffer Continuously demo (pnpm example:long-buffer). JSON is the slow path only.
Phase 6 is the 3D engine: mesh3d primitives with depth + Lambert lighting, orbit/pan/zoom camera, point cloud / surface / line / bars / mesh, and pnpm example:cloud / example:surface.
Phases 7–13 close the product surface: financial candles (pnpm example:finance), GeoJSON maps (pnpm example:map), React/Next lifecycle, Python SDK, REST/WS API, playground, CI, Docker, and a11y/i18n/export.
React: mount with ReactChartHandle and append via the handle, never useState per sample. Next: loadClientChart / clientLoaders — GPU never initializes on the server.
| Package | Role |
|---|---|
@rekhly/types |
Shared contracts and typed errors |
@rekhly/engine |
Scene, render graph, frame loop, renderer selection |
@rekhly/renderer-webgl |
WebGL2 backend |
@rekhly/renderer-canvas |
Canvas 2D fallback |
@rekhly/renderer-webgpu |
WebGPU stub (not production-ready) |
@rekhly/core |
Public chart entry (rekhly.chartXY) — never calls WebGL directly |
@rekhly/charts-2d |
XY/polar/Smith/oscilloscope/eye-diagram/density-map charts, series, axes, markers, limit lines, cursor, legend, components/plugins |
@rekhly/interaction |
Pointer, zoom, pan |
@rekhly/themes |
Light / dark + Midnight, Graphite, Ocean, Aurora, Solarized, High Contrast |
@rekhly/data |
Buffers, pool, LTTB/LOD, HUD |
@rekhly/streaming |
Ring buffer, binary frames, WS/SSE clients |
@rekhly/charts-3d |
chart3D, orbit camera, point cloud, surface |
@rekhly/charts-finance |
Candles, volume, depth |
@rekhly/indicators |
Optional SMA/EMA/RSI/… (no renderer) |
@rekhly/charts-geospatial |
GeoJSON maps, no map SDK |
@rekhly/react / @rekhly/next |
Lifecycle + SSR guards |
@rekhly/platform |
Schema, gallery registry, codegen |
New here? docs/guides/getting-started.md walks through npm install → first chart in both JavaScript and Python, no prior charting-library experience assumed. Building/contributing to this monorepo itself uses:
pnpm install
pnpm test
pnpm typecheck
pnpm build
import { rekhly } from "@rekhly/core";
const chart = rekhly.chartXY({
container: "#host",
theme: "dark",
});
const series = chart.addLineSeries().setData({ x: xF32, y: yF32 });
chart.cursor.enable({ mode: "crosshair", snap: true });
await chart.ready;
chart.dispose();
pnpm example:line
The core is WebGL2 and runs with or without a GPU:
| Environment | What happens |
|---|---|
GPU + webgl2 |
Hardware WebGL2 (renderer.device === "gpu") |
| No GPU / headless / CI | Software WebGL2 (renderer.device === "software") |
Same renderer, same scene graph. Canvas 2D is opt-in only (force: "canvas"). WebGPU is a documented milestone — forcing it throws WebGPUUnavailableError. See packages/renderer-webgpu/README.md.
dispose() is idempotent on charts, engines, and renderers. A second call is a safe no-op.
Do not implement Rekhly as a wrapper around Chart.js, Highcharts, ECharts, Plotly, Recharts, D3-as-renderer, or any commercial charting engine. D3 may only be used later for math utilities — never primary rendering.
The name of any competing chart product must not appear in UI, package names, branding, or marketing copy.
Got any questions? I'm happy to help with products, licensing, and examples.