Skip to content
This repository has been archived by the owner on Nov 21, 2021. It is now read-only.

soc221b/vuex-light

Repository files navigation

WARNING: This package is no longer to be maintained, use Pinia instead.

vuex-light

npm npm bundle size GitHub Workflow Status (branch) npm downloads last commit

Why

Have you ever wanted to have type-ahead feature or intelligense when commit a mutation or dispatch actions?

Have you want to use such a token which is saved in the store and you cannot inject useStore hook due to you aren't in setup lifecycle?

Features

  • 💡 Better DX - consistent and intuitive interface
  • 💪 Robust typescript support
  • VM agnostic - you can directly import and use it anywhere, no matter whether in setup lifecycle or not.

Getting Started

Setup

via npm

yarn add vuex-light

via cdn

<script src="https://unpkg.com/vuex-light@latest"></script>

Getting Started

Create the simplest store:

// ./store.ts
import { createStore } from 'vuex-light'

const store = createStore(
  // state
  {
    count: 0,
  },
  // getters
  {},
  // mutations
  {
    increment({ state }) {
      state.count++
    },
  },
)

export function useStore() {
  return store
}
<!-- ./App.vue -->
<template>
  Clicked: {{ store.state.count }} times.
  <button @click="store.mutations.increment">+</button>
</template>

<script lang="ts">
  import { defineComponent } from 'vue'
  import { useStore } from './store'

  export default defineComponent({
    setup() {
      const { state, mutations } = useStore()

      return {
        state,
        mutations,
      }
    },
  })
</script>

API

Core

const store = createStore(
  // state
  {
    count: 0,
  },
  // getters
  {
    isOdd({ state, getters }) {
      // ...
    },
  },
  // mutations
  {
    increment({ state, getters, mutations }, ...payloads) {
      // ...
    },
  },
  // actions
  {
    incrementIfOdd({ state, getters, mutations, actions }, ...payloads) {
      // ...
    },
  },
  // modules
  {
    module: createStore(
      // state
      {
        moduleCount: 0,
      },
    ),
  },
)

store.state.count
store.getters.isOdd
store.mutations.increment()
store.actions.incrementIfOdd()
store.modules.module.state.moduleCount

Plugins

createLoggerPlugin

https://iendeavor.github.io/vuex-light/vuex-light.createloggerplugin.html

createPersistPlugin

https://iendeavor.github.io/vuex-light/vuex-light.createpersistplugin.html

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details