Dash Leaflet is a light wrapper around React-Leaflet. The syntax is similar to other Dash components, with naming conventions following the React-Leaflet API.

The easiest way to get started is to install the latest version of Dash and Dash Leaflet via pip.

pip install dash
pip install dash-leaflet

Once the installation is completed, paste the following lines of code into a .py file and run it.

from dash import Dash
import dash_leaflet as dl

app = Dash()
app.layout = dl.Map(dl.TileLayer(), style={'height': '50vh'}, center=[56, 10], zoom=6)

if __name__ == '__main__':
    app.run_server()

That's it! If you visit https://127.0.0.1:8050/ in your browser, you should see a Leaflet map.

The documentation has been moved to a separate page to enable an interactive example gallery.

NB: The 1.0.0 release contains a wide range of breaking changes, please refer to the migration guidelines

Please ask questions on StackOverflow using the dash-leaflet tag, use GitHub issues only for bug reports.

Start by cloning this repository,

git clone [email protected]:thedirtyfew/dash-leaflet.git
cd dash-leaflet

Next, create a virtual environment and install the python dependencies,

python3 -m venv venv && . venv/bin/activate
pip install -r requirements.txt

Finally, install packages via npm (ignore errors) and run the build script,

npm i --ignore-scripts
npm run build