---
title: "Installation"
description: "Install @movk/mapbox and its peer dependencies, then choose between Nuxt or Vue + Vite setup."
canonical_url: "https://mapbox.mhaibaraai.cn/en/docs/getting-started/installation"
---
# Installation

> Install @movk/mapbox and its peer dependencies, then choose between Nuxt or Vue + Vite setup.

## Requirements

> [!NOTE]
> 
> - **Mapbox GL JS** — v3 (`mapbox-gl` as a peer dependency)
> - **Vue** — 3.4+
> - **Node.js** — `^20.19.0 || >=22.12.0`
> - A **Mapbox access token** ([get one for free](https://account.mapbox.com/access-tokens/)); if you need Tianditu basemaps, you'll also need a Tianditu `tk`

## Install Dependencies

```bash [pnpm]
pnpm add @movk/mapbox mapbox-gl
```

```bash [npm]
npm install @movk/mapbox mapbox-gl
```

```bash [yarn]
yarn add @movk/mapbox mapbox-gl
```

For drawing support (`MapboxDrawControl`), also install:

```bash [pnpm]
pnpm add @mapbox/mapbox-gl-draw
```

```bash [npm]
npm install @mapbox/mapbox-gl-draw
```

```bash [yarn]
yarn add @mapbox/mapbox-gl-draw
```

## Choose a Setup Method

**Nuxt 4**

Register as a Nuxt module — components and composables are auto-imported.

**Vue + Vite**

Use the Vite plugin + vue-plugin to use the same components in a plain Vue project.


## Sitemap

See the full [sitemap](https://mapbox.mhaibaraai.cn/sitemap.md) for all pages.