Skip to content


Switch branches/tags

Latest commit

* Packing inside group

* Change checkbox type

Co-authored-by: Ilfat Galiev <>
Co-authored-by: bongshin <>

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Jan 28, 2022

Build Status


Charticulator is a new charting tool that allows you to design charts by interactively specifying constraints.

Project Team


Follow the following steps to prepare a development environment:

Install node modules:


Copy the template configuration file and edit its contents:

cp config.template.yml config.yml
# (on windows, use copy instead of cp)

Run the following command to build Charticulator, which will create a self contained bundle in the dist folder:

yarn build

Run a local web server to test Charticulator:

# Serve Charticulator at http://localhost:4000
yarn server

# Serve Charticulator publicly at
# Use this if you want to enable access from another computer
yarn public_server


For a live development environment, keep the following command running:

yarn start

This command watches for any change in src/ and sass/, and recompiles Charticulator automatically. Once this up, open http://localhost:4000/ to launch Charticulator. Now when you change the source code, the app can be updated by simply refreshing the browser page (you may need to disable browser cache).

In development mode, there is a test application for UI components, which can be accessed at http://localhost:4000/test.html.

The watch mode won't update when you change the following:

  • config.yml
  • webpack.config.js

When you update these, please do yarn build again.

Sample Datasets

You can add custom sample datasets that can be used with Charticulator. To do so, create a datasets folder at the root of the repository(if it doesn't exist), add your .csv (or .tsv) to that folder, and finally create a files.json file in the folder with the following contents:

        "name": "<Your dataset display name>",
        "description": "<Your dataset desription>",
        "tables": [
                "name": "<Your dataset file name without extension>",
                "type": "<csv || tsv>",
                "url": "<Your dataset file name with extension>"


Charticulator currently include a rudimentary test code:

yarn test

More test cases are needed.


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.


Run yarn typedoc to generate documentation pages. The page will be awailable in ./docs/charticulator

Start point of documentation is index page {@link "index"}