VueUse - Collection of essential Vue Composition Utilities VueUse - Collection of essential Vue Composition Utilities
Collection of essential Vue Composition Utilities

NPM version NPM Downloads Docs & Demos Function Count
GitHub stars

• 🎪 Interactive docs & demos
• 🕶 Seamless migration: Works for both Vue 3 and 2
• ⚡ Fully tree shakeable: Only take what you want, bundle size
• 🦾 Type Strong: Written in TypeScript, with TS Docs
• 🔋 SSR Friendly
• 🌎 No bundler required: Usable via CDN
• 🔩 Flexible: Configurable event filters and targets
• 🔌 Optional Add-ons : Router, Firebase, RxJS, etc.

import { useLocalStorage, useMouse, usePreferredDark } from '@vueuse/core'
export default {
 setup() {
 // tracks mouse position
 const { x, y } = useMouse()
 // is user prefers dark theme
 const isDark = usePreferredDark()
 // persist state in localStorage
 const store = useLocalStorage(
 'my-storage',
 {
 name: 'Apple',
 color: 'red',
 },
 )
 return { x, y, isDark, store }
 },
}

Refer to functions list or documentations for more details.

🎩 From v4.0, it works for Vue 2 & 3 within a single package by the power of vue-demi!

npm i @vueuse/core

Add ons | Nuxt Module

From v6.0, VueUse requires vue >= v3.2 or @vue/composition-api >= v1.1

• Vite + Vue 3
• Nuxt 3 + Vue 3
• Webpack + Vue 3
• Nuxt 2 + Vue 2
• Vue CLI + Vue 2

<script src="https://unpkg.com/@vueuse/shared"></script>
<script src="https://unpkg.com/@vueuse/core"></script>

It will be exposed to global as window.VueUse

Alt

See the Contributing Guide

This project is heavily inspired by the following awesome projects.

• streamich/react-use
• u3u/vue-hooks
• logaretm/vue-use-web
• kripod/react-hooks

And thanks to all the contributors on GitHub!

MIT License © 2019-PRESENT Anthony Fu