Version | Description |
---|---|
Leaflet 1.3.3 | Stable version, released on July 18, 2018. |
Leaflet 1.3-dev | In-progress version, developed on the master branch. |
Leaflet 0.7.7 | Legacy version, released on November 18, 2013 and last updated on October 26, 2015. |
Note that the master version can contain incompatible changes, so please read the changelog carefully when upgrading to it.
The latest stable Leaflet release is available on several CDN’s — to start using
it straight away, place this in the head
of your HTML code:
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.3.3/dist/leaflet.css" />
<script src="https://unpkg.com/leaflet@1.3.3/dist/leaflet.js"></script>
To avoid potential security problems, we recommend and encourage enabling subresource integrity when using Leaflet from a CDN:
<link rel="stylesheet" href="https://unpkg.com/leaflet@1.3.3/dist/leaflet.css"
integrity="sha512-Rksm5RenBEKSKFjgI3a41vrjkw4EVPlJ3+OiI65vTjIdo9brlAacEuKOiQ5OFh7cOI1bkDwLqdLw3Zg0cRJAAQ=="
crossorigin=""/>
<script src="https://unpkg.com/leaflet@1.3.3/dist/leaflet.js"
integrity="sha512-tAGcCfR4Sc5ZP5ZoVz0quoZDYX5aCtEm/eu1KhSLj2c9eFrylXZknQYmxUssFaVJKvvc0dJQixhGjG2yXWiV9Q=="
crossorigin=""></script>
Leaflet is available on the following free CDN’s: unpkg, cdnjs, jsDelivr
Disclaimer: these services are external to Leaflet; for questions or support, please contact them directly.
Inside the archives downloaded from the above links, you will see four things:
leaflet.js
- This is the minified Leaflet JavaScript code.leaflet-src.js
- This is the readable, unminified Leaflet JavaScript, which is sometimes helpful for debugging. (The integrity hash for this file is leaflet.css
- This is the stylesheet for Leaflet.images
- This is a folder that contains images referenced by leaflet.css
. It must be in the same directory as leaflet.css
.Unzip the downloaded archive to your website’s directory and add this to the head
of your HTML code:
<link rel="stylesheet" href="/path/to/leaflet.css" />
<script src="/path/to/leaflet.js"></script>
If you use the npm
package manager, you can fetch a local copy of Leaflet by running:
npm install leaflet
You will find a copy of the Leaflet release files in node_modules/leaflet/dist
.
These download packages above only contain the library itself. If you want to download the full source code, including unit tests, files for debugging, build scripts, etc., you can download it from the GitHub repository.
Leaflet build system is powered by the Node.js platform, which installs easily and works well across all major platforms. Here are the steps to set it up:
npm install
Now that you have everything installed, run npm run build
inside the Leaflet directory.
This will combine and compress the Leaflet source files, saving the build to the dist
folder.