/vue-enterprise-boilerplate

An ever-evolving, very opinionated architecture and dev environment for new Vue SPA projects using Vue CLI 3.

Primary LanguageJavaScript

Vue Enterprise Boilerplate

CircleCI

This is an ever-evolving, very opinionated architecture and dev environment for new Vue SPA projects using Vue CLI 3. Questions, feedback, and for now, even bikeshedding are welcome. 😄

⚠️ This project uses Vue CLI 3, which is currently in beta so may not yet be appropriate for production projects.

Features

  • Thorough documentation: Written with the same care as Vue's core docs to quickly train new team members and consolidate knowledge.
  • Guaranteed consistency: Opinionated linting for Vue, JavaScript/JSON, SCSS, and Markdown, integrated into Visual Studio Code and run against staged files on pre-commit.
  • First-class tests: Practice test-driven development with both unit and end-to-end tests. Unit tests with Jest live as first-class citizens alongside your source files, while Cypress provides reliable end-to-end tests in an intuitive GUI for development.
  • Speedy development: Between configurable generators, handy aliases, and global base components, your productivity will skyrocket.

Getting started

# 1. Clone the repository.
git clone https://github.com/chrisvfritz/vue-enterprise-boilerplate.git my-new-project --depth 1

# 2. Enter your newly-cloned folder
cd my-new-project

# 3. Replace this README's CI badge with a note about when you started
# and a link to a compare URL, so that you can always get an overview
# of new features added to the boilerplate since you did.
node _start.js

# 4. Delete the start script, as there can be only one beginning.
rm _start.js

Documentation

This project includes a docs folder with more details on:

  1. Setup and development
  2. Architecture
  3. Languages and technologies
  4. Routing, layouts, and views
  5. State management
  6. Tests and mocking the API
  7. Linting and formatting
  8. Editor integration
  9. Building and deploying to production