Skip to content

vue-vine/vue-vine

Repository files navigation

Vue Vine

Another style of writing Vue components.

  • NPM version:   NPM Version
  • VSCode extension:   VSCode ext version
  • Check more details in docs:   Netlify Status
Why this ?

There are many discussions in community that hopes for a solution that supports writing multiple Vue components in a single file. That's why Vue Vine was born.

Vue Vine was designed to provide more flexibility of managing Vue components. It is a parallel style to SFC.

Take a quick view:

Quick view

Relavant packages

Category Package Version Description
core @vue-vine/compiler NPM Version Compiler
core @vue-vine/language-server NPM Version Language Server
core @vue-vine/language-service NPM Version Language Service
core @vue-vine/vite-plugin NPM Version Vite Plugin
eslint @vue-vine/eslint-parser NPM Version ESLint Parser
eslint @vue-vine/eslint-plugin NPM Version ESLint Plugin
eslint @vue-vine/eslint-config NPM Version ESLint Config
nuxt @vue-vine/nuxt NPM Version Nuxt Module
tsc vue-vine-tsc NPM Version TypeScript CLI checker
CLI create-vue-vine NPM Version Project starter CLI

Install

# If you didn't install `@antfu/ni` yet, I highly recommend you to install it.
ni -D vue-vine

Use the plugin in vite.config.ts:

import { VineVitePlugin } from 'vue-vine/vite'

export default defineConfig({
  plugins: [
    // ...Other plugins
    VineVitePlugin()
  ],
})

Then add macro's type definition in tsconfig.json:

{
  "compilerOptions": {
    "types": ["vue-vine/macros"]
  }
}

For ESLint, install our custom ESLint config:

ni -D @vue-vine/eslint-config

You need to load the config into your flat configs.

import antfu from '@antfu/eslint-config'

// `VueVine()` returns a ESLint flat config
import VueVine from '@vue-vine/eslint-config'

export default antfu(
  {
    // First option is not Linter.FlatConfig,
    // it's a setting for antfu's config itself
  },
  ...VueVine(),
)

Finally, install the VSCode extension, search Vue Vine in the marketplace.

image

Try the demo

You can try the demo by following steps:

For development environment setup, first you need to get the VSCode extension bundle ouput.

git clone https://github.com/vue-vine/vue-vine.git
cd vue-vine
pnpm install

# Build all packages
pnpm run build

After building the VSCode extension, you can open the 'Debug' tab in VSCode, and start the 'Run Vine Extension' debug session.

image

Then start the Playground's dev server in another terminal session.

pnpm run play
  1. You can see the demo in http://localhost:3333/.
  2. You can inspect the transforming process in http://localhost:3333/__inspect/