README.md

CARTO + deck.gl examples

This is a collection of examples tailored by the CARTO team to showcase different possibilities when developing with CARTO and deck.gl.

About CARTO + deck.gl

CARTO + deck.gl is the best way to build large-scale geospatial applications. It is scalable, performant, easy to set up, and doesn't require you to migrate your data or build a complex backend. If you're new to CARTO or deck.gl, we recommend you to read our Documentation first.

All data in the examples is being queried live from a data warehouse (EG: Google BigQuery, Snowflake, Amazon Redshift, Databricks, PostgreSQL...), using a connection previously created in CARTO. For these examples we already created and maintain that connection, but you can connect your data and create your own examples and applications at any time.

Running the examples

All examples can be replicated locally in your computer or live in your browser with StackBlitz.

Using the examples with Stackblitz

Opening an example in Stackblitz will automatically start a live browser environment that contains all the necessary dependencies to run the example. You can interact with the examples or make your own live edits. You can fork the examples in your own Stackblitz account if needed.

Local setup using deck.gl master branch

All the examples have a script dev-local that can be used to link with the master branch of https://github.com/visgl/deck.gl.

In order to use those scripts you need to do the following.

Firts, clone both repos:

git clone https://github.com/visgl/deck.gl
git clone https://github.com/CartoDB/deck.gl-examples

Initialize deck.gl

cd deck.gl
yarn 
yarn bootstrap
# yarn build to refresh in the future

Link all

cd modules/<module>
yarn link

Initialize deck.gl-examples

cd deck.gl-examples
yarn 
yarn link-deck
# yarn unlink-deck

Execute the environment:

yarn dev-local 
# or
npm run dev-local