Vuex on large projects: How to structure it ?

2 min read
Mustafa Dalga
Nov 12, 2021

Table of contents

If you are using vuex in a small project, you can keep state, mutation, getters, and actions in a single file.

On the other hand, when developing a large project, we can divide vuex into modules based on categories, thereby keeping file sizes down, keeping the code cleaner, and increasing the chances of more than one developer being able to work on the project at the same time.

We can also separate state, mutation, getters, and actions within these modules. By using vuex modules, we want to increase manageability and understandability.

I will explain and show how to create modules per categories in this blog post. I will divide this blog post into two parts and explain how to exchange data between these modules in the second post, so as not to prolong it.


  1. auth: This module stores and processes data about user accounts.
  2. movies: This module stores and processes data about movies.
  3. notifications: This module stores and processes data about warnings, errors, etc.
Vuex modules

Every module has its own state, mutations, getters, and actions files.

Module files

In each module, we create an index.js file that collects state, mutations, getters, and actions.

import state from './state';
import getters from './getters';
import mutations from './mutations';
import actions from './actions'

export default {
namespaced: true,

We import these modules and define them in the main store file index.js.

import { createStore } from 'vuex'
import auth from './modules/auth';
import movies from "./modules/movies";
import notifications from "./modules/notifications";

export default createStore({
modules: {

main.js uses it as follows:

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
import store from './store'


As a result, vuex needs to be used more accurately to provide a more manageable and clean project.

The sample project is on my github account and the demo is on netlify.


From the blog

The latest industry news, interviews, technologies, and resources.
No items found.