Public | Automated Build

Last pushed: 2 years ago
Short Description
A charting tool that produces automatic, shareable charts from any data file
Full Description


Charted is a tool for automatically visualizing data, originally created by
the Product Science team at Medium. Provide the
link to a data file and Charted returns a beautiful, interactive,
and shareable chart of the data. The charts look like this:

Charted is deliberately sparse in formatting and data transformation options,
and instead gives you a few powerful core features:

  • Rendering well on all screen sizes, including monitors
  • Re-fetching the data and updating the chart every 30 minutes
  • Moving data series into separate charts
  • Adjusting the chart type, labels/titles, and background

Supported files

Charted currently supports the following file types:

  • .csv files
  • .tsv files
  • Google Spreadsheets (set to shareable)
  • Dropbox share links to supported files

Data structure

Charted treats the first column of the data file as the labels for the
x-axis. All subsequent columns are added as y-series. Charted does not
parse the first column (x-axis), but instead always equally spaces the
data points along the x-axis.

Running Charted

To try Charted out, simply download the repo and run npm install
to install dependencies. After that you will be able to run
npm start. This will start a server at localhost:3000.

If you install Watchman, you can
run bin/watch to automatically recompile whenever you change JavaScript
or LESS files.

On Heroku

With Docker

You can also run Charted via docker by running
docker build -t charted . in the repo to build the container. You
will then be able to run the container using
docker run -p 3000:3000 charted. Server will be accessible at

Using the Node module

Charted also comes as a Node module which can be included in an
Express or Matador application. This lets you direct the user to
Charted URLs within the app, which can fetch data from other routes.
(Note that Charted adds an endpoint which can make GET requests to
arbitrary URLs from your app.)

Call charted(app) to set up Charted in your app. By default, the
Charted home page and assets will be served from /charted/, which
you can customize the path by providing another path as a second
argument. For example, providing '/' will cause Charted to be served
from the root of your app.

Docker Pull Command
Source Repository