CartoDB javascript library
JavaScript CSS Smarty Other
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Add github files Apr 20, 2018
config/jsdoc Changing repo references Apr 17, 2018
docs FAQs Apr 18, 2018
examples Setting googlemaps v3.31 (`release`) as the highest supported version Apr 25, 2018
grunt Setting googlemaps v3.31 (`release`) as the highest supported version Apr 25, 2018
scripts Update package.publish.json Apr 17, 2018
src Merge pull request #2104 from CartoDB/4314-round-zoom-level Apr 25, 2018
test Setting googlemaps v3.31 (`release`) as the highest supported version Apr 25, 2018
themes Fix top and bottom margin in Bubble container legend Apr 17, 2018
vendor Fix LZMA for both public and internal bundles Dec 13, 2017
webpack Add sourcemap generation to build script Jan 17, 2018
.editorconfig Add editorconfig Sep 5, 2017
.eslintignore Remove BOWER stuff Nov 14, 2017
.eslintrc.json Fix no-mixed-operators lint Sep 11, 2017
.gitignore Ignore docs/internal Feb 12, 2018
.gitmodules Run tests from the command line using PhantomJS Apr 24, 2013
.hound.yml Enabling Hound + adding scss lint Oct 6, 2015
.npmrc Add npm version configuration Oct 4, 2017
.scss-lint.yml Introducing widget tooltip for any widget Dec 2, 2015
.travis.yml Add publish:npm script Dec 11, 2017 Changing repo references Apr 17, 2018 Add CHANGELOG and DEVLOG Apr 4, 2018
Gemfile First changes for new cartodb.js landing page for development Nov 4, 2014
Gruntfile.js Carto.js -> CARTO.js Dec 14, 2017
LICENSE.txt Remove .md files and simplify Nov 21, 2017 Fix typo Apr 17, 2018
gulpfile.js Fix huge lint Sep 11, 2017
index.html Moved dist to dist/internal Nov 14, 2017
package.json Bump version to 4.0.2-0 Apr 25, 2018
secrets.example.json Update publish CDN task. Add release:cdn command Dec 12, 2017

CARTO.js 4.0

CARTO.js is a JavaScript library to create custom location intelligence applications that leverage the power of CARTO. It is the library that powers Builder and it is part of the Engine ecosystem.

Getting Started

The best way to get started is to navigate through the CARTO.js documentation site:

  • Guide will give you a good overview of the library.
  • API Reference will help you use a particular class or method.
  • Examples will demo some specific features.
  • Support might answer some of your questions.


We use SemVer for versioning.

Please refer to for a list of notables changes for each version of the library.

You can also see the tags on this repository.

Submitting Contributions

You will need to sign a Contributor License Agreement (CLA) before making a submission. Learn more here.


This project is licensed under the BSD 3-clause "New" or "Revised" License - see the LICENSE.txt file for details.


API Reference

Run npm run docs to build the API reference documentation from jsdoc annotations.

Once the task is done, you can visit docs/public/index.html to check the reference

General documentation

You can read the general documentation that is published at also in this repo. They are written in Markdown.

Warning: internal links in these documents don't work. They are replaced when the documentation is published in


The folder docs/guides contains general information about the CARTO.js library.

  • Quickstart: get started quickly following this tutorial.
  • Upgrade considerations: if you have experience with previous versions of CARTO.js, this is the place to learn the differences between the former library and the newest one.
  • Glossary: terms that appear throughout the documentation.


In the folder examples/public you can find several folders with example for every feature of CARTO.js.

Reference topics

The document docs/reference/ contains general considerations when working with CARTO.js. It's advisable to read them before diving in the API reference.


The folder docs/support contains several document with support documentation: support options, FAQs, error messages...


Run the tests

npm test

Build the library

npm run build

To watch the files

npm run build:watch

Generate the docs

npm run docs

Release version

npm run bump

To publish a release to the CDN and npm

npm run release

Looking for the previous version?

Previous version cartodb.js v3 it's available here