· 4 min · vue javascript web frontend

Complex Vue.js App Structure

I have always liked it whenever a framework provides it's own generators and/or boilerplates. It's what I liked about Ruby on Rails the most after the MVC concept. Developers can understand a lot about the framework and the way it's intended to be used from the official boilerplates. I am sad that the recent javascript frameworks has left this important job of generating code to the community and tools like yeoman instead of having something official.

When I started looking into Vue.js, I was happy to discover that they have a small generator tool called vue-cli which can be used with official boilerplates provided at vuejs-templates. Unfortunately, the happiness didn't last long because the boilerplates are simple applications meant to get you started with Vue.js. They don't deal with all the other necessary packages such as vuex, vue-router, etc.. which are needed for a complex Vue.js application. (EDIT: At the time of writing this post, vue-router wasn't present in the boilerplate). They did allow the tool to use third party boilerplates which resulted in me creating spoiler built upon the official webpack boilerplate.

I would like to describe below about what I think should be the directory and file structure of a complex Vue.js application and it's conventions.


The following example assumes that you will be using webpack build config from vuejs-templates/webpack boilerplate.

Let's also assume that you want to have a page named Hello, it will need a vue.js component named Hello and a vuex module named Hello.

├─ src
  ├─ assets               # module assets (processed by webpack)
  │  └─ ...
  ├─ components
  │  └─ Hello.vue         # Hello component
  │  └─ ...
  ├─ store
  │  └─ Hello.js          # Hello module
  │  └─ index.js          # assemble vuex store
  │  └─ ...
  ├─ router
  │  └─ index.js          # app route configuration
  │  └─ ...
  ├─ App.vue              # main app component
  └─ main.js              # app entry file
├─ public                  # static assets (directly copied)
  └─ ...
├─ index.html              # index.html template
└─ package.json            # build scripts and dependencies


This is the main HTML template for your application. You can link your static assets inside the head tag while your processed assets will be auto injected in body.

<!DOCTYPE html>
    <link rel="shortcut icon" type="image/png" href="/assets/images/favicon.png"/>

    <div id="app"></div>


This is the file which initiates vue-router with the given components.

import Vue from 'vue';
import VueRouter from 'vue-router';
import Hello from '@/components/Hello';


const routes = [
  { path: '/', name: 'Hello', component: Hello },

/* eslint-disable no-new */
export default new VueRouter({
  mode: 'history',


This is the file which initiates vuex store with the given modules.

import Vue from 'vue';
import Vuex from 'vuex';
import Hello from '@/store/Hello';


/* eslint-disable no-new */
const store = new Vuex.Store({
  modules: {

export default store;


This is the application's main Vue.js component which is basically just a wrapper for vue-router.

  <div id="app">

export default {};


This is the application entry file where you initiate your Vue.js application with a router, store and the main App.vue component.

import Vue from 'vue';
import router from '@/router';
import store from '@/store';
import App from '@/App';

/* eslint-disable no-new */
new Vue({
  el: '#app',
  render: h => h(App),


This file represents a sample vuex module.

export default {
  namespaced: true,
  state: {
    message: 'Hello Vue!',


This file represents a sample Vue.js component which will be used by the vue-router. Please note that Hello module's state is being used in here.

  <div class="hello">
    <h1>{{ message }}</h1>

import { mapState } from 'vuex';

export default {
  data() {
    return {};
  computed: mapState({
    message: state => state.Hello.message,


Why is router a directory instead of a single file?

When applications grow, the number of routes grow. They might contain beforeEnter hooks and so on and sometimes you might want to put all that in a separate file, or files. With a subdirectory you can keep this all in one place without bloating one router.js file.

Why are there no root actions and mutations in vuex?

In large applications, almost everything should be as independent of each other for better maintainability and readability of the codebase. Having root actions and mutations will hamper that and thus is not recommended.

Final Comments

I wish the official webpack template supports vue-router, vuex, etc.. and hopefully guide lot of developers to the correct way of using Vue.js. I also wish it contains some subcommands which can be used when creating a new component or module so that the official conventions are encouraged.

  • LinkedIn
  • Tumblr
  • Reddit
  • Pinterest
  • Pocket