Dec 28, 2015
Recently there has been a lot of discussion around the tooling hurdle when you start a React project. Luckily for Vue.js, all you need to do to start with a quick prototype is including it from a CDN via a
<script> tag, so we’ve got that part covered. However, that’s not how you’d build a real world application. In real world applications we inevitably need a certain amount of tooling to give us modularization, transpilers, pre-processors, hot-reload, linting and testing. These tools are necessary for the long-term maintainability and productivity of large projects, but the initial setup can be a big pain. This is why we are announcing vue-cli , a simple CLI tool to help you quickly scaffold Vue.js projects with opinionated, battery-included build setups.
Just The Scaffolding
The usage looks like this:
npm install -g vue-cli
vue init webpack my-project
# answer prompts
npm run dev # tada!
All the CLI does is pulling down templates from the vuejs-templates organization on GitHub. Dependencies are handled via NPM, and build tasks are simply NPM scripts.
The purpose of official Vue project templates is providing opinionated, battery-included development tooling setups so that users can get started with actual app code as fast as possible. However, these templates are un-opinionated in terms of how you structure your app code and what libraries you use in addition to Vue.js.
All official project templates are repos in the vuejs-templates organization . When a new template is added to the organization, you will be able to run
vue init <template-name> <project-name> to use that template. You can also run
vue list to see all available official templates.
Current available templates include:
browserify – A full-featured Browserify + vueify setup with hot-reload, linting & unit testing.
browserify-simple – A simple Browserify + vueify setup for quick prototyping.
webpack – A full-featured Webpack + vue-loader setup with hot reload, linting, testing & css extraction.
webpack-simple – A simple Webpack + vue-loader setup for quick prototyping.
Bring Your Own Setup
If you are not happy with the offical templates, you can fork these templates, modify them to fit your specific needs (or even create your own from scratch), and use them via
vue-cli too, because
vue-cli can work directly on GitHub repos:
vue init username/repo my-project
Vue Components Everywhere
There are different templates for different purposes: simple setups for quick prototyping, and full-featured setups for ambitious applications. A common feature among these templates though, is that they all support
*.vue single file components. This means any third party Vue components written as valid
*.vue files can be shared among projects using these setups, and simply be distributed over NPM – let’s create more reusable components!