Generate a chart from a spreadsheet using a c3 spec.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A Node.js module for rendering a chart from a CSV file using a C3 spec.

It can be used from the command line or as a code library. It's a great way to render server-side charts.

This library uses Data-Forge, Nightmare and C3.

For help please see this example repo and this post on The Data Wrangler.

If you are interested in server-side / Node.js charting and visualization my book Data Wrangling with JavaScript has a whole chapter on this.

Use from command line


npm install -g c3-chart-maker


c3-chart-maker <input-file> --chart=<c3-chart-file> --out=<output-image-file> [--export=<folder>] [--template=<chart-template-folder>] [--show] [--dump-chart] [--verbose]


chart       Specifies the file that defines the chart.
out         Specifies the name of the image file to output for the chart.
export      Optionally specify a folder to export the interactive chart to.
show        Optional parameter that shows the browser that renders the chart.
dump-chart  Dump the expanded chart definition to standard out for debugging.
template    Template directory that contains the HTML and CSS files for the chart. You can use this to completely override the chart template.
verbose     Enable this option for verbose debug output.


c3-chart-maker myspreadsheet.csv --chart=mychartspec.json --out=mychart.png --show --dump-chart 

Use as a code library


npm install --save c3-chart-maker


const c3ChartMaker = require('c3-chart-maker');

var inputFilePath = "your-input-file.csv"; // NOTE: This can also be a DataForge dataframe, an array of data or a path to a JSON file.
var chartTemplateFilePath = "my-chart-spec.json"; // NOTE: This can also be inline JSON or the path to a Node.js module with a function that builds the chart definition.
var outputFilePath = "your-chart-output-file.png";
var options: {
    show: true                  // Show browser used to render the chart.
    dumpChart: true,            // Dump the expanded chart definition to the console for debugging.
    export: "folder-path",      // Optionally specify a folder to export an interactive chart to.
    template: "folder-path"     // Optionally override the chart template with your own custom version.

c3ChartMaker(inputFilePath, chartTemplateFilePath, outputFilePath, options)
    .then(() => { 
    .catch(err => {