Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Stores made simple

Today Pinia is reaching its first release version, and surprisingly, it's not the v1, it's the v2! After 19 Alphas, 5 Betas, and 15 release candidates, almost 2 years from its initial release, 0.0.1, Pinia is now reaching v2.0.0 🎉!

Thanks a lot to everybody who has been using it, specially those trying it out in its early stages (pre v1, with Vue 2).

Pinia has around 80k downloads per month and you can already find a few plugins on npm!. It has become the most complete yet light Store for Vue. It's type safe by default, highly extensible, provides advanced devtools support, is modular by design, making your bundles smaller, and will feel familiar to any person already using Vue with both, an Option and a Setup API.

You can read how it compares to Vuex on the documentation.

Going stable

After entering v2, Pinia will not release breaking changes like it used to in alphas, betas, and rcs. It will focus on providing a great DX through its typings, devtool plugin, and third party plugins. More concrete documentation in the form of Cookbook entries and maybe even videos, are yet to come!

Why skip v1?

Initially, I was keeping two active branches for Pinia and I was releasing v.0.x.x versions at the same time as v2.0.0-0 versions, back-porting across repositories any fixes and new features. This was sometimes easy to deal with with git cherry-pick but when that didn't work, it quickly became hard to keep both branches in sync. At some point, I managed to merge both branches together by using vue-demi and obtain a version of Pinia that worked with both Vue 2 and Vue 3. After that, I decided to stop working on the v1 branch and focus on the v2, which has now reached a stable release version. Because of this, there was never (and will never be) a v1.0.0.

What is next?

Pinia has been production ready for a couple of months now. The only reason it was kept in an RC state was to be able to bring minor breaking changes until the API felt completely right. Now it's time to focus on keeping it up to date with any improvements we might come up for Vuex 5. The fate of Pinia is not clear yet but it shall either be absorbed by Vuex or become a superset of it, keeping its API as aligned as possible with Vuex 5.

Trying it out

If you want to give Pinia a quick try, check out this demo with Vue 3 or this other one with Nuxt 3. You can find a complete list of the examples here.

To learn more about Pinia, take a loot at the documentation.

Supporting Pinia development

If your company uses Vue Router, please consider supporting its development by supporting me 🙏 . It will mean a lot and really help me to keep working on improving the Vue Ecosystem.

If you were already using the release candidate version of Pinia, you can find the list of improvements on the CHANGELOG.md.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

Please refer to CHANGELOG.md for details.

• feat: access the state and getters through this (#190) (7bb7733)
• refactor: use defineComponent (cae8fca)

Breaking changes

There is no longer a state property on the store, you need to directly access any property

store.state.counter
// becomes
store.counter

getters no longer receive parameters, directly call this.myState to read state and other getters:

getters: {
  doubleCount: state => state.counter * 2
  // becomes
  doubleCounte() {
    return this.counter * 2
  }
}

More at #190

• fix: make pinia work with nuxt Composition API plugin (#180) (f4e2583)

• refactor: fix type issues (d5265f6)
• fix: avoid nuxtContext in spa mode (#170) (a0d10f9)
• docs: disableVuex in nuxt.config.js (f3e9a32)
• feat: support raw Vue SSR (#90) (91d7b38)

• refactor: rename details about branch (786ea50)
• Merge branch 'master' into next (d1285e3)
• chore: up deps (957ae31)
• docs: update demo link (2361d8f)
• docs: clearer implications of where to call useStore (1d6aee1)
• chore(deps-dev): bump rollup from 1.29.0 to 1.29.1 (c3454fe)
• chore(deps-dev): bump @typescript-eslint/eslint-plugin (695f1fa)
• chore(deps-dev): bump codecov from 3.6.1 to 3.6.2 (16fcc42)
• chore(deps-dev): bump @typescript-eslint/parser from 2.16.0 to 2.17.0 (331071a)
• chore(deps-dev): bump @types/jest from 24.9.0 to 24.9.1 (a00ccd8)
• chore(deps-dev): bump jest and ts-jest (29ec77f)
• feat: make it work with vue 3 (54505cb)

BREAKING CHANGES

After taking a deeper look at what is necessary for SSR, a few things had to change:

• Actions are no longer just functions, they must be attached to the store by being passed directly to createStore and they are called as methods of the store (e.g. store.reset())
• createStore now takes an object instead of positional arguments

// before
export const useMainStore = createStore(
  // id
  'main',
  // state
  () => ({ counter: 0 }),
  // getters
  {
    doubleCount: state => state.counter * 2,
  }
)

export function reset() {
  const store = useMainStore()
  store.state.counter = 0
}

// now
export const useMainStore = createStore({
  id: 'main',
  state: () => ({ counter: 0 }),
  getters: {
    doubleCount: state => state.counter * 2,
  },
  actions: {
    reset() {
      this.state.counter = 0
    },
  },
})

• feat: allow using getters in other getters (859eeb3)
• feat: allow empty state option to make it easy to group stores (810e0f0)
• feat: add nuxt module (4c0ef7a)
• feat: allow passing the req to useStore (f250622)
• fix: bind the actions to the store (5e262da)
• feat: allow useStore to be called within a store (fdf6b45)
• feat: handle SSR state hydration (2998d53)
• feat: state hydration (db72247)
• feat: export types, support state hydration (89996ed)

• fix: loose TS type for StateTree (092f169)
• chore: readme (cae35e6)
• docs: add demo (33acec1)

• fix: global vueCompositionApi name (a23acef)
• docs: remove old tasks (1c594ff)
• test: store.subscribe (#29) (ceb1cd1)
• chore: up deps (6e4ae12)
• wip: pinia (6bb041b)
• docs: Fix typo in Readme in patch section (#17) (1afe265)
• chore: typo (871c252)
• chore: up dep (aedde4e)
• docs: adapt readme (f45c84a)
• docs: adapt pinia proposal (c10fa42)
• chore: remove old param (59b67f3)
• v0.0.2 (074668d)
• docs: add more (10c02f0)
• refactor: apply code from readme (85a5dde)
• docs: new lines (980ff41)
• docs: minor (531eadc)
• docs: fix link (5fcafbf)
• refactor: remove old code (11eed2b)
• docs: add readme (2dcc3ef)
• chore: up lock (567522c)