Skip to content

Getting Started

Vue Macros is a library that implements unofficial proposals and ideas for Vue, exploring and extending its features and syntax.

We assume you are already familiar with the basic usages of Vue before you continue.

Requirements

  • Node.js >= v16.14.0.
  • Vue >= v2.7 or Vue >= v3.0.
    • Some features need Vue >= v3.2.25.
  • VSCode extension Vue - Official and vue-tsc are v2.1.6
    • Vue Macros will continue to adapt to the latest version as soon as possible, older versions may not be supported.

WARNING

WebStorm is not supported.

Creating a Vue Macros Project

Installation

bash
npm i -g @vue-macros/cli
bash
yarn global add @vue-macros/cli
bash
pnpm add -g @vue-macros/cli

This command will install @vue-macros/cli, the official Vue Macros scaffolding tool.

Initialization

bash
npm create vite@latest my-vue-macros -- --template vue-ts
cd my-vue-macros
vue-macros init
bash
yarn create vite my-vue-macros --template vue-ts
cd my-vue-macros
vue-macros init
bash
pnpm create vite my-vue-macros --template vue-ts
cd my-vue-macros
vue-macros init

You will be presented with prompts for several optional experimental features.

Templates

🌟 More templates are welcome!

Nuxt Integration

If you're using Nuxt 3, read the Nuxt Integration.

Bundler Integrations

If you're using Vite, Rollup, esbuild, Webpack, or Rspack, read the Bundler Integration.

Contributors

Changelog