{"id":49674,"library":"vue-upgrade-tool","title":"Vue Upgrade Tool","description":"A codemod tool for automatically migrating Vue 2 projects to Vue 3. Version 1.0.37 is the current stable release. Built on vue-metamorph, it upgrades JS/TS files, single-file components (SFCs), and unit tests. Provides over 15 plugins covering common breaking changes like emits option, data function, v-on .native removal, render function API, and more. Results require manual verification. Community-maintained on GitHub with active development.","status":"active","version":"1.0.37","language":"javascript","source_language":"en","source_url":"https://github.com/UnrefinedBrain/vue-upgrade-tool","tags":["javascript"],"install":[{"cmd":"npm install vue-upgrade-tool","lang":"bash","label":"npm"},{"cmd":"yarn add vue-upgrade-tool","lang":"bash","label":"yarn"},{"cmd":"pnpm add vue-upgrade-tool","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core transformation engine for all codemod plugins","package":"vue-metamorph","optional":false}],"imports":[{"note":"Use npx to avoid global install; project-specific usage is recommended.","wrong":"npm install -g vue-upgrade-tool && vue-upgrade-tool","symbol":"vue-upgrade-tool (CLI)","correct":"npx vue-upgrade-tool --files 'src/**/*'"}],"quickstart":{"code":"npx vue-upgrade-tool --files 'src/**/*.vue' --plugins 'vue-*' --plugins 'test-utils-*' > vue_upgrade_output.txt","lang":"bash","description":"Run all Vue and test-utils transformation plugins on all .vue files in src/ and save output to a file for review."},"warnings":[{"fix":"Use multiple `--plugins` flags (e.g., `--plugins 'vue-*' --plugins 'test-utils-*'`) instead of a single comma-separated value.","message":"The `--plugins` flag accepts micromatch patterns; if you pass a comma-separated list it may not work as expected.","severity":"deprecated","affected_versions":">=0.1.0"},{"fix":"Run a formatter like Prettier or ESLint after applying changes.","message":"The tool does not format code; output may have inconsistent formatting.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Review the output file and test your application after migration.","message":"Results are not guaranteed perfect; always manually verify each change.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use `npx vue-upgrade-tool --list-plugins` to see current plugin names.","message":"Plugin IDs changed between versions; refer to the plugin list with `--list-plugins`.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.37':17 '15':42 '2':11 '3':15 'activ':73 'api':60 'automat':8 'break':46 'built':23 'chang':47 'codemod':5 'common':45 'communiti':68 'community-maintain':67 'compon':35 'cover':44 'current':20 'data':51 'develop':74 'emit':49 'file':31,34 'function':52,59 'github':71 'javascript':75 'js/ts':30 'like':48 'maintain':69 'manual':65 'metamorph':27 'migrat':9 'nativ':56 'option':50 'plugin':43 'project':12 'provid':40 'releas':22 'remov':57 'render':58 'requir':64 'result':63 'sfcs':36 'singl':33 'single-fil':32 'stabl':21 'test':39 'tool':3,6 'unit':38 'upgrad':2,29 'v':54 'v-on':53 'verif':66 'version':16 'vue':1,10,14,26 'vue-metamorph':25","created_at":"2026-06-07T17:03:01.204736+00:00","updated_at":"2026-06-07T17:03:01.204736+00:00","problems":[{"fix":"Use `npx vue-upgrade-tool` or install locally with `npm install --save-dev vue-upgrade-tool`.","cause":"Global install without npx or missing local dependency.","error":"Error: Cannot find module 'vue-upgrade-tool'"},{"fix":"Check the pattern with a tool like `glob`; ensure files exist in the path.","cause":"Incorrect glob pattern or no files in specified directory.","error":"The `--files` pattern matched no files"},{"fix":"Use `vue-emits-sfc` or `vue-emits-non-sfc` as the plugin ID; run `--list-plugins` for exact names.","cause":"Plugin name changed or missing pattern.","error":"Unrecognized plugin: 'vue-emits'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/UnrefinedBrain/vue-upgrade-tool#readme","github":"https://github.com/UnrefinedBrain/vue-upgrade-tool","docs":null,"changelog":null,"pypi":null,"npm":"vue-upgrade-tool","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}