Go to file
2024-05-26 00:45:19 +08:00
.github first commit 2024-05-23 15:34:45 +08:00
config/jsdoc first commit 2024-05-23 15:34:45 +08:00
docs first commit 2024-05-23 15:34:45 +08:00
examples first commit 2024-05-23 15:34:45 +08:00
grunt first commit 2024-05-23 15:34:45 +08:00
scripts first commit 2024-05-23 15:34:45 +08:00
src 更新 'src/api/v4/error-handling/error-list/windshaft-errors.js' 2024-05-23 15:45:41 +08:00
test first commit 2024-05-23 15:34:45 +08:00
themes 更新 'themes/scss/map/_attributions.scss' 2024-05-26 00:45:19 +08:00
vendor first commit 2024-05-23 15:34:45 +08:00
webpack first commit 2024-05-23 15:34:45 +08:00
.editorconfig first commit 2024-05-23 15:34:45 +08:00
.eslintignore first commit 2024-05-23 15:34:45 +08:00
.eslintrc.json first commit 2024-05-23 15:34:45 +08:00
.gitignore first commit 2024-05-23 15:34:45 +08:00
.hound.yml first commit 2024-05-23 15:34:45 +08:00
.npmrc first commit 2024-05-23 15:34:45 +08:00
.scss-lint.yml first commit 2024-05-23 15:34:45 +08:00
.travis.yml first commit 2024-05-23 15:34:45 +08:00
CHANGELOG_INTERNAL.md first commit 2024-05-23 15:34:45 +08:00
CHANGELOG.md first commit 2024-05-23 15:34:45 +08:00
Gruntfile.js first commit 2024-05-23 15:34:45 +08:00
gulpfile.js first commit 2024-05-23 15:34:45 +08:00
index.html first commit 2024-05-23 15:34:45 +08:00
LICENSE first commit 2024-05-23 15:34:45 +08:00
package-lock.json first commit 2024-05-23 15:34:45 +08:00
package.json first commit 2024-05-23 15:34:45 +08:00
README.md first commit 2024-05-23 15:34:45 +08:00
secrets.example.json first commit 2024-05-23 15:34:45 +08:00
SECURITY-POLICY.md first commit 2024-05-23 15:34:45 +08:00
security.txt first commit 2024-05-23 15:34:45 +08:00

CARTO.js 4

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.

Versioning

We use SemVer for versioning.

Please refer to CHANGELOG.md 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.

License

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

Documentation

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 https://carto.com/developers/carto-js/ 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 https://carto.com/

Guides

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.

Examples

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

Reference topics

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

Support

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

Development

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