https://github.com/vuejs/create-vue
🛠️ The recommended way to start a Vite-powered Vue project
https://github.com/vuejs/create-vue
vite vue vue3 vuejs
Last synced: 3 days ago
JSON representation
🛠️ The recommended way to start a Vite-powered Vue project
- Host: GitHub
- URL: https://github.com/vuejs/create-vue
- Owner: vuejs
- License: other
- Created: 2021-07-14T07:58:55.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-30T05:33:26.000Z (10 days ago)
- Last Synced: 2025-04-30T06:32:02.675Z (10 days ago)
- Topics: vite, vue, vue3, vuejs
- Language: Vue
- Homepage:
- Size: 14.3 MB
- Stars: 4,053
- Watchers: 33
- Forks: 475
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- trackawesomelist - Create Vue (⭐3.8k)
README
# create-vue 
The recommended way to start a Vite-powered Vue project
## Usage
To create a new Vue project using `create-vue`, simply run the following command in your terminal:
```sh
npm create vue@latest
```
> [!IMPORTANT]
> (`@latest` or `@legacy`) MUST NOT be omitted, otherwise `npm` may resolve to a cached and outdated version of the package.
By default, the command runs in interactive mode with prompts. You can skip these prompts by providing feature flags as CLI arguments. To see all available feature flags and options:
```sh
npm create vue@latest -- --help
```
This will show you various feature flags (like `--typescript`, `--router`) and options (like `--bare` for creating a project with minimal boilerplate).
**PowerShell users:** You'll need to quote the double dashes: `npm create vue@latest '--' --help`
### Creating Vue 2 Projects
If you need to support IE11, you can create a Vue 2 project with:
```sh
npm create vue@legacy
```
> [!WARNING]
> [Vue 2 Has Reached End of Life](https://v2.vuejs.org/eol/)
## Difference from Vue CLI
- Vite-Powered: Vue CLI is based on webpack, while `create-vue` is based on [Vite](https://vite.dev/). Vite supports most of the configured conventions found in Vue CLI projects out of the box, and provides a significantly better development experience due to its extremely fast startup and hot-module replacement speed. Learn more about why we recommend Vite over webpack [here](https://vite.dev/guide/why.html).
- Scaffolding Tool: Unlike Vue CLI, `create-vue` itself is just a scaffolding tool. It creates a pre-configured project based on the features you choose, and delegates the rest to Vite. Projects scaffolded this way can directly leverage the [Vite plugin ecosystem](https://vite.dev/plugins/) which is Rollup-compatible.
## Migrating from Vue CLI
If you're transitioning from Vue CLI to Create Vue, we've got you covered. Here are some resources to help you with the migration:
How to Migrate from Vue CLI to Vite
- Vue CLI to Vite Migration Guide: A comprehensive guide on migrating from Vue CLI to Vite, available on [VueSchool.io](https://vueschool.io/articles/vuejs-tutorials/how-to-migrate-from-vue-cli-to-vite/)
- Tools and Plugins for Migration: For a smoother transition, check out the list of tools and plugins designed to assist with the migration process on the
[Awesome Vite GitHub page](https://github.com/vitejs/awesome-vite#vue-cli).