Skip to content
On this page

Nuxt 3 and Pinia

Integrate Pinia as your state management library for your Nuxt 3 application.

Vuex -> Pinia

Evan You, the creator of Vue himself, has stated "Pinia is de facto Vuex 5! At this point it’s really a naming/branding issue."

For the time being, it's probably best to be looking towards Pinia content rather than Vuex.

"Pinia is de facto Vuex 5! At this point it’s really a naming/branding issue."

I recommend reading VueJS's official post regarding this to get a better understanding as to why Pinia > Vuex.

Installing Pinia in Nuxt 3

Pinia nearly comes with first-class support for Nuxt 3. You'll need to install two packages:

yarn add pinia
yarn add @pinia/nuxt

Add Pinia to your nuxt.config file

You'll need to add '@pinia/nuxt' to your modules array.

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@pinia/nuxt'],

Build your Pinia store

Now build a named store. For my use-case, I needed to manage state regarding filters, so the skeleton of my store looks like:

// store/filters.ts
import { defineStore } from 'pinia'

export const useFiltersStore = defineStore({
  id: 'filter-store',
  state: () => {
    return {
      filtersList: ['youtube', 'twitch'],
  actions: {
    addValueToFilterList(value: string) {
  getters: {
    filtersList: state => state.filtersList,

This is just showing the general structure of your store. The key is to defineStore and make sure to include an id. In this case, I'm using 'filter-store' as my id but it could be anything you prefer.

Read over Pinia's Docs to get a better grasp of how to use Pinia properly.

Alternative Pinia Store Syntax

The above example is a valid Pinia store using a pattern similar to Vue's Options API. You can also define your store using a syntax similar to the Composition API.

Here's how you can build the above example in a composable way:

// store/filters.ts
import { defineStore } from 'pinia'

export const useFiltersStore = defineStore('filterStore', () => {
  const filtersList = ref(['youtube', 'twitch'])

  function addValueToFilterList(value: string) {
  return { addValueToFilterList, filtersList }

We just reduced the amount of code significantly. Pretty cool, right? I personally prefer the composition.

Instead of relying on the state, action, and getter boilerplate, we use Vue's ref, computed, and traditional Javascript functions to manage our state.

Bring Pinia in Vue Component

With our store in place, simply import it into the component you want to use it in and have fun!

// components/FilterMenu.vue
<script setup>
import { useFiltersStore } from '~/store/filters'
import { storeToRefs } from 'pinia'

const inputVal = ref('')

const filtersStore = useFiltersStore()
const { addValueToFilterList } = filtersStore
const { filtersList } = storeToRefs(filtersStore)

    {{ filtersList }}
    <input v-model="inputVal" />
    <button @click="addValueToFilterList(inputVal)">+</button>

The line import { storeToRefs } from 'pinia' allows us to maintain a reactive getter. In this case, we are destructuring the filterList getter from our filtersStore.

Here's the repo if you'd like to see a working project.