motion-v-skilld
Skill184 starsChanged 37 days agoMITView on GitHub
ALWAYS load when writing or debugging code that imports "motion-v" (Motion for Vue, motion-vue). Covers the motion component, AnimatePresence, variants, gestures, layout, scroll, motion values, the v-motion directive, and the Nuxt module for version 2.4.4. Provides API facts, recipes, best practices, and migration notes.
- Installs packages
In this repository35 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- floating-ui-vue-skilldSkill
- formkit-core-skilldSkill
- pinia-colada-skilldSkill
- pinia-skilldSkill
- primevue-skilldSkill
- quasar-skilldSkill
- reka-ui-skilldSkill
- shadcn-vue-skilldSkill
- slidev-cli-skilldSkill
- tanstack-ai-vue-skilldSkill
- tanstack-vue-form-skilldSkill
- tanstack-vue-query-skilldSkill
- tanstack-vue-router-skilldSkill
- tanstack-vue-store-skilldSkill
- tanstack-vue-table-skilldSkill
- tanstack-vue-virtual-skilldSkill
- tresjs-core-skilldSkill
- unhead-vue-skilldSkill
- unovis-ts-skilldSkill
- unovis-vue-skilldSkill
- vee-validate-skilldSkill
- vitepress-skilldSkill
- vue-data-ui-skilldSkill
- vue-i18n-skilldSkill
- vue-router-skilldSkill
- vue-skilldSkill
- vue-test-utils-skilldSkill
- vuetify-skilldSkill
- vueuse-components-skilldSkill
- vueuse-core-skilldSkill
- vueuse-integrations-skilldSkill
- vueuse-math-skilldSkill
- vueuse-motion-skilldSkill
- vueuse-shared-skilldSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 1 is distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 43
When animate values change, the element animates to them.
- Very specific: line 55
Use m plus LazyMotion instead of motion when bundle size matters.
- Very specific: line 61
Never put v-if on AnimatePresence itself.
- Distinctive: line 62
Put the condition on the direct child instead:
- Very specific: line 80
Add layoutScroll on scrollable ancestors and layoutRoot on fixed position ancestors.
- Very specific: line 88
Use dynamic variants with custom for stagger, not computed delays in reactive state.
- Very specific: line 96
Use v-motion for plain elements when a wrapper component does not fit.
- Very specific: line 102
Use whileFocus, whileHover, whilePress, whileInView for animation, and event props like onHoverStart for logic.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
motion-v (Motion for Vue) 2.4.4
Motion for Vue is the Vue port of Motion (formerly Framer Motion). It animates DOM and SVG through props, motion values, and a hybrid engine.
Facts, all verified from the prepared source:
- Package:
motion-v2.4.4, MIT, ESM only (package.json:4, package.json:20-33). - Peer deps:
vue >= 3.0.0,@vueuse/core >= 10.0.0(package.json:53-56). - Engine deps:
framer-motion,motion-dom,motion-utils, all^13.3.0(package.json:57-62). - Entry points:
motion-v,motion-v/nuxt,motion-v/resolver(package.json:20-33). - The root entry re-exports all of
framer-motion/dom(dist/es/index.d.ts:1). Soanimate,stagger,arc, easing functions, and more come from the Motion engine. - Repo and docs: https://github.com/motiondivision/motion-vue, https://motion.dev/docs/vue
Quick start
npm install motion-v<script setup>
import { motion } from 'motion-v'
</script>
<template>
<motion.div :initial="{ opacity: 0 }" :animate="{ opacity: 1, x: 100 }" />
</template>motion is a namespace of typed components for every HTML and SVG tag
(dist/es/components/motion/index.d.ts:3-182). motion.div, motion.svg, motion.path and so on.
Core model
- Set
initial,animate,exit,whileHover,whilePress,whileInView,whileFocus,whileDragto values or variant labels. - When
animatevalues change, the element animates to them. transitionconfigures timing, spring, delay, stagger.variantspluscustomsupport dynamic, per element targets.- Animatable values include independent transforms (
x,y,scale,rotate,skewX), colors, and CSS variables (dist/es/types/state.d.ts:45-47). - In templates, bind motion props with
:prefix. They are props, not attributes.
Full prop and hook listing: references/api-surface.md
Hard rules
These rules prevent the most common bugs. Each cites its source.
- Use
mplusLazyMotioninstead ofmotionwhen bundle size matters.motionships all features, about 34 kb.mstarts near 6 kb. LoaddomAnimationfor variants, gestures, exit. LoaddomMaxfor drag and layout. Setstrictto catch straymotionusage in dev. https://motion.dev/docs/vue-lazymotion, dist/es/components/lazy-motion/index.d.ts:4-13 Never put
v-ifonAnimatePresenceitself. If it unmounts, it cannot intercept child exits. Put the condition on the direct child instead:<AnimatePresence> <motion.div v-if="isVisible" :exit="{ opacity: 0 }" /> </AnimatePresence>- For layout animations, apply changing CSS to
:style, never to:animate. Thelayoutprop animates the measured change. Values in:animatefight the FLIP measurement. https://motion.dev/docs/vue-layout-animations - Set
borderRadiusandboxShadowas inline styles onlayoutelements. Motion corrects scale distortion for these two only when they are motion values in:style. https://motion.dev/docs/vue-layout-animations#scale-correction - Add
layoutScrollon scrollable ancestors andlayoutRooton fixed position ancestors. Without them, layout measurement is wrong when scroll or viewport offset is non zero. dist/es/components/motion/props.d.ts:71-78 - Set
reducedMotion="user"on a rootMotionConfig. The default is"never", so animations ignore the OS accessibility setting unless you opt in. dist/es/components/motion-config/types.d.ts:5-20 - Use dynamic variants with
customfor stagger, not computed delays in reactive state. Pass:custom="index"and resolvedelayinside the variant function. https://motion.dev/docs/vue-animation - Render live motion values with
<RowValue :value="mv" />in demos and readouts. It writesinnerHTMLdirectly and keeps fast values off the Vue render path. dist/es/components/RowValue.d.ts:1-15 - Use
v-motionfor plain elements when a wrapper component does not fit. Register it globally withapp.use(MotionPlugin), or create presets withcreatePresetDirective. The directive supports SSR throughgetSSRPropsand defaults todomMaxfeatures. dist/es/directive/index.mjs:153-172 - Gesture shorthand props
focus,hover,press,inViewwere removed in v2.0.0. UsewhileFocus,whileHover,whilePress,whileInViewfor animation, and event props likeonHoverStartfor logic. See references/migration.md
Common tasks
Enter and exit, stagger, drag, scroll linked, imperative useAnimate, shared layout, Reorder lists, directive usage, LazyMotion, and Nuxt setup, each with a runnable snippet: references/recipes.md
Changes since the 2.2.1 baseline
- 2.3.0:
arc()motion along an arc, usable astransition: { path: arc(...) }.useAnimatenow respectsMotionConfig skipAnimations. - 2.4.0: multidimensional Reorder,
axis="xy"onReorder.Group. - 2.4.2: exit and enter animations restored for
KeepAlivecached components. - 2.4.4: Nuxt module no longer transpires
motion-vin builds.
Details and links: references/migration.md
Version specific notes
- SVG positions use
attrX,attrY,attrScaleinstead ofx,y,scale(dist/es/types/state.d.ts:15-20). useSpringaccepts a value or aMotionValuesource and returns the matching type (dist/es/value/use-spring.d.ts:6-7).useTransformmaps ranges and also returns a named map of outputs in one call (dist/es/value/use-transform.d.ts:54-97).AnimatePresencesupportsmodesync,wait,popLayout, plusanchorXfor popLayout exit direction (dist/es/components/animate-presence/types.d.ts:1-8).- Directive and components share one resolver, so
v-motioninherits variant, presence, and config context (dist/es/utils/resolve-motion-props.d.ts:11-15).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

