> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/mapbox-gl-js/llms.txt)

# Getting Started

To get started with **Mapbox GL JS**, choose the method that fits your project setup:

**Get Started with CDN**

Add Mapbox GL JS to a web project using hosted resources on the Mapbox Content Delivery Network (CDN) and instantiate a map.

> **Related content (guide): [Get started with Mapbox GL JS using a CDN](https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-cdn/)**

```html
  <link href="https://api.mapbox.com/mapbox-gl-js/v3.28.1/mapbox-gl.css" rel="stylesheet">
  <script src="https://api.mapbox.com/mapbox-gl-js/v3.28.1/mapbox-gl.js"></script>
```

---

**Get Started with NPM**

Add Mapbox GL JS to a web project using npm and a modern JavaScript framework and instantiate a map.

> **Related content (guide): [Get started with Mapbox GL JS using npm](https://docs.mapbox.com/mapbox-gl-js/guides/get-started/use-with-npm/)**

```sh
   npm install mapbox-gl
```

---

**Scaffold a web map project**

Use our `npm create @mapbox/web-app` utility to scaffold a new project with Mapbox GL JS implemented into the front end framework of your choice.

> **Related content (guide): [Scaffold a web map project](https://docs.mapbox.com/mapbox-gl-js/guides/get-started/scaffold-web-app/)**

```sh
  npm create @mapbox/web-app
```