Vuex Electron

The easiest way to share your Vuex Store between all processes (including main).

Features

:star: Persisted state
:star: Shared mutations

Requirements

• Vue v2.0+
• Vuex v2.0+
• Electron v2.0+

Installation

Installation of the Vuex Electron easy as 1-2-3-4.

1. Install package with using of yarn or npm:

   yarn install superleo-vuex-electron

   or

   npm install superleo-vuex-electron

2. Include plugins in your Vuex store::

   import Vue from "vue"
   import Vuex from "vuex"
   
   import { createPersistedState, createSharedMutations } from "superleo-vuex-electron"
   
   Vue.use(Vuex)
   
   export default new Vuex.Store({
     // ...
     plugins: [
       createPersistedState(),
       createSharedMutations()
     ],
     // ...
   })

3. In case if you enabled createSharedMutations() plugin you need to create an instance of store in the main process. To do it just add this line into your main process (for example src/main.js):

   import './path/to/your/store'

4. It is important that you must use the initRenderer() method into your main process:

   import { initRenderer } from 'superleo-vuex-electron'
   initRenderer()

5. Well done you did it! The last step is to add the star to this repo :smile:

Usage example: Vuex Electron Example

IMPORTANT

In renderer process to call actions you need to use dispatch or mapActions. Don't use commit because actions fired via commit will not be shared between processes.

Options

Available options for createPersistedState()

createPersistedState({
  whitelist: ["whitelistedMutation", "anotherWhitelistedMutation"],

  // or

  whitelist: (mutation) => {
    return true
  },

  // or

  blacklist: ["ignoredMutation", "anotherIgnoredMutation"],

  // or

  blacklist: (mutation) => {
    return true
  }
})

Author

Andrew Emelianenko
IG: @truemelianenko

License

MIT License