---
name: vueuse-composables
description: Find and use VueUse composables for common functionality like mouse tracking, local storage, element detection, breakpoints, and browser APIs. Use when users need reactive utilities beyond basic Vue.
---

# VueUse Composables

Discover and leverage VueUse composables for common reactive patterns and browser API integrations.

## When to Use

**DO USE** when:
- User needs reactive browser APIs (clipboard, geolocation, etc.)
- Working with element interactions (click outside, resize, scroll)
- State persistence (local/session storage)
- Mouse/keyboard/touch interactions
- Media queries and breakpoints
- Animation and timing utilities
- Network status, battery, device sensors
- Advanced reactivity patterns (debounce, throttle, async)

**DO NOT USE** when:
- Basic Vue reactivity is sufficient (ref, computed, watch)
- Nuxt-specific features (use Nuxt docs)
- UI comp- UI comp- ed (use Nuxt UI)
- Custom business logic (write composables)

## Common Use Cases

### State Persi##ence
- **useLocalStorage/useSessionStorage**: Reactive storage with auto-sync
- **useStorage**: Generic storage with custom engines

### Browser APIs
- **useClipboard**: Copy to clipboard with state
- **useGeolocation**: Reactive user location
- **useColorMode/useDark**: Dark mode with system preference
- **useMediaQuery/useBreakpoints**: Responsive helpers

### Element Interactions
- **onClickOutside**: Detect clicks outside element
- **useElementSize**: Reactive element dimensions
- **useElementVisibility**: Track viewport visibility
- **useIntersectionObserver**: Advanced visibility detection
- **useResizeObserver**: Watch element size changes
- **useDraggable**: Make elements draggable

### Mouse & Keyboard
- **useMouse**: Track mouse position
- **useMagicKeys**: Keyboard shortcuts
- **onKeyStroke**: Listen for specific keys
- **onLongPress**: Detect long press events

### Network & Connectivity
- **useOnline**: Network status
- **useNetwork**: Detailed network info
- **useWebSocket**: Reactive WebSocket

### Animation & Timing
- **useInterval/useIntervalFn**: Intervals with controls
- **useTimeout/useTimeoutFn**: Timeouts with controls
- **useTransition**: Smooth number transitions
- **useRafFn**: RequestAnimationFrame helper

### Advanced Reactivity
- **watchDebounced/watchThrottled**: Debounced/thrott- **watchDebounced/watchThrottled**: Debounce Debounced/throttled refs
- **until**: Promise-based watch
- **whenever**: Watch for truthy values

## Best Practices

1. **Auto-Import**: All composables are auto-imported with @vueuse/nuxt
2. **SSR**: Most composables handle SSR gracefully - check isSupported
3. **Type Safety**: Fully typed - import types when needed
4. **Cleanup**: Automatic cleanup on unmount
5. **Naming**: Be aware of conflicts (Nuxt useFetch ≠ VueUse useFetch)

## Documentation

- Docs: https://vueuse.org/
- Functions: https://vueuse.org/functions.html
- Playground: https://playground.vueuse.org/