an open-source JavaScript library
for mobile-friendly interactive maps

Leaflet Tutorials

Every tutorial here comes with step-by-step code explanation and is easy enough even for beginner JavaScript developers.

Leaflet Quick Start Guide

A simple step-by-step guide that will quickly get you started with Leaflet basics, including setting up a Leaflet map (with Mapbox tiles) on your page, working with markers, polylines and popups, and dealing with events.

Leaflet on Mobile

In this tutorial, you’ll learn how to create a fullscreen map tuned for mobile devices like iPhone, iPad or Android phones, and how to easily detect and use the current user location.

Markers with Custom Icons

In this pretty tutorial, you’ll learn how to easily define your own icons for use by the markers you put on the map.

Using GeoJSON with Leaflet

In this tutorial, you’ll learn how to create and interact with map vectors created from GeoJSON objects.

Interactive Choropleth Map

A case study of creating a colorful interactive choropleth map of US States Population Density with GeoJSON and some custom controls. News websites will love this.

Layer Groups and Layers Control

A tutorial on how to manage groups of layers and use the layer switching control.

Non-geographical maps

A primer on L.CRS.Simple, how to make maps with no concept of “latitude” or “longitude”.


How to integrate with WMS and TMS services from professional GIS software.

Working with map panes

How the default map panes work to display overlays on top of tiles, and how to override that.

The following tutorials cover how to create plugins for Leaflet, and are intended only for developers experienced in Javascript:

Extending Leaflet: Class Theory

An overview of Leaflet’s classes, class inheritance, and conventions.

Extending Leaflet: Layers

How to extend layers or create new ones, using specific entry points for doing so.

Extending Leaflet: Handlers and Controls

How to extend or create non-layers.