ChartForgeX 1.3.0

ChartForgeX - Dependency-Free Chart Rendering for .NET

ChartForgeX renders polished charts, animated visual stories, visual blocks, topology diagrams, and static report visuals from .NET without adding runtime chart dependencies to generated output.

The core package renders SVG, script-free HTML, PNG, GIF, APNG, JPEG, BMP, PPM, and TIFF. TerminalStory creates PowerShell, Bash, command prompt, Python, C#, or custom console presentations from structured commands and output, with independent palettes and macOS, Windows Terminal, minimal, or chrome-free window styles. VisualStory generalizes that model to source, terminal, text, image, SVG, and result panels, with declared outcomes that must remain visible in the completed scene. The core consumes resolved artifacts and renderer-neutral syntax spans; it never executes showcased code or depends on a language parser. PNG, print, and reduced-motion output keep the exact completed state. Optional browser behavior lives in adapter packages, so generated reports can stay static while dashboard hosts can opt into tooltips, selection, zoom, pan, synchronized charts, and export controls.

Install

dotnet add package ChartForgeX

ChartForgeX targets net472, netstandard2.0, net8.0, and net10.0. The core package has no runtime package dependencies.

Visual Tour

These previews are generated by ChartForgeX.Examples and checked into the public repository. HTML links open through the Evotec preview service so the generated pages render directly.

Dashboard composition	Topology and geography
HTML / SVG / PNG	HTML / SVG / PNG

Operational dashboard grids	Report-ready small multiples
HTML / SVG / PNG	HTML / SVG / PNG

More generated output is available in the GitHub gallery artifacts and on the project site.

Quick Start

using ChartForgeX;
using ChartForgeX.Core;
using ChartForgeX.Primitives;
using ChartForgeX.Themes;
using System.Linq;

var chart = Chart.Create()
    .WithTitle("Domain Security Checks")
    .WithSubtitle("Dependency-free SVG, HTML, and PNG chart rendering")
    .WithXAxis("Run")
    .WithYAxis("Checks")
    .WithTheme(ChartTheme.ReportDark())
    .WithSize(1180, 640)
    .WithXLabels("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
    .AddSmoothArea("Passed", Points(820, 940, 980, 1040, 1120, 1180, 1230))
    .AddSmoothLine("Warnings", Points(120, 138, 132, 110, 98, 86, 72), ChartColor.FromRgb(251, 191, 36));

chart.SaveSvg("domain-security.svg");
chart.SavePng("domain-security.png");
chart.SaveHtml("domain-security.html");

static ChartPoint[] Points(params double[] values) =>
    values.Select((value, index) => new ChartPoint(index, value)).ToArray();

Typed Data and Scales

Hosts keep their own records and map them directly into native charts. ChartDataset<T> provides immutable filter, sort, projection, grouping, summary, and numeric-bin operations without introducing a second chart-definition API.

using ChartForgeX.Core;
using ChartForgeX.Data;

var samples = ChartDataset<Sample>.From(new[] {
    new Sample(1, 32),
    new Sample(2, 48),
    new Sample(3, 61)
});

var chart = Chart.Create()
    .WithTitle("CPU")
    .WithYAxis("Percent")
    .ConfigureYAxis(axis => axis.WithBounds(0, 100))
    .AddLine("CPU", samples, sample => sample.Index, sample => sample.Value);

chart.SavePng("cpu.png");
chart.SaveSvg("cpu.svg");

record Sample(double Index, double Value);

ChartAxis centralizes bounds, ticks, labels, and Linear, Logarithmic, SymmetricLogarithmic, or Time scaling. Direct helpers such as ChartPoints.FromValues(...) remain available for small inline datasets.

Output API

RasterImageOptions controls JPEG quality, PNG compression level, and the flattening background for opaque formats.

Links

• Repository: https://github.com/EvotecIT/ChartForgeX
• Documentation and examples: https://chartforgex.evotec.xyz/
• Issues: https://github.com/EvotecIT/ChartForgeX/issues