# Installation

# Direct Download / CDN

https://unpkg.com/vuex(opens new window)

Unpkg.com(opens new window) provides NPM-based CDN links. The above link will always point to the latest release on NPM. You can also use a specific version/tag via URLs like https://unpkg.com/vuex@2.0.0.

Include vuex after Vue and it will install itself automatically:

<script src="/path/to/vue.js"></script>
<script src="/path/to/vuex.js"></script>


npm install vuex --save

# If using Vue 3.0 + Vuex 4.0:
npm install vuex@next --save

# Yarn

yarn add vuex

# If using Vue 3.0 + Vuex 4.0:
yarn add vuex@next --save

When used with a module system, you must explicitly install Vuex as a plugin:

# With Vue 2

import Vue from 'vue'
import Vuex from 'vuex'


# With Vue 3

import { createApp } from 'vue'
import { createStore } from 'vuex'

const app = createApp({ ... })
const store = createStore({ ... })


You don't need to do this when using global script tags.

# Promise

Vuex requires Promise(opens new window) . If your supporting browsers do not implement Promise (e.g. IE), you can use a polyfill library, such as es6-promise(opens new window) .

You can include it via CDN:

<script src="https://cdn.jsdelivr.net/npm/es6-promise@4/dist/es6-promise.auto.js"></script>

Then window.Promise will be available automatically.

If you prefer using a package manager such as NPM or Yarn, install it with the following commands:

npm install es6-promise --save # NPM
yarn add es6-promise # Yarn

Furthermore, add the below line into anywhere in your code before using Vuex:

import 'es6-promise/auto'

# Dev Build

You will have to clone directly from GitHub and build vuex yourself if you want to use the latest dev build.

git clone https://github.com/vuejs/vuex.git node_modules/vuex
cd node_modules/vuex
npm install
npm run build