{"id":22909,"library":"vite-plugin-version-mark","title":"vite-plugin-version-mark","description":"A Vite and Nuxt plugin (v0.2.2) that automatically injects version information from package.json, git commit SHA, or custom commands into your application via console logs, global variables, meta tags, and static output files. It supports multi-command execution with custom format templates, aliases, timeouts, and fallbacks. Particularly useful for tracking deployed builds and debugging in production. Ships TypeScript types. Requires Vite or Nuxt 3.3+. Released under MIT.","status":"active","version":"0.2.2","language":"javascript","source_language":"en","source_url":"https://github.com/ZhongxuYang/vite-plugin-version-mark","tags":["javascript","vite","version","vue","nuxt","react","git","commit","log","typescript"],"install":[{"cmd":"npm install vite-plugin-version-mark","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-version-mark","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-version-mark","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency for Vite-based projects","package":"vite","optional":false},{"reason":"peer dependency for Nuxt integration","package":"@nuxt/kit","optional":true},{"reason":"peer dependency for Nuxt integration","package":"@nuxt/schema","optional":true}],"imports":[{"note":"Named export only; no default export. ESM-only, not CJS compatible.","wrong":"import vitePluginVersionMark from 'vite-plugin-version-mark'","symbol":"vitePluginVersionMark","correct":"import { vitePluginVersionMark } from 'vite-plugin-version-mark'"},{"note":"TypeScript type import; do not use as value.","wrong":"import { VitePluginVersionMarkInput } from 'vite-plugin-version-mark'","symbol":"VitePluginVersionMarkInput","correct":"import type { VitePluginVersionMarkInput } from 'vite-plugin-version-mark'"},{"note":"Nuxt module is a separate entry point from 'vite-plugin-version-mark/nuxt'.","wrong":"import { nuxtModule } from 'vite-plugin-version-mark'","symbol":"nuxtModule","correct":"import { nuxtModule } from 'vite-plugin-version-mark/nuxt'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport { vitePluginVersionMark } from 'vite-plugin-version-mark';\n\nexport default defineConfig({\n plugins: [\n vitePluginVersionMark({\n ifShortSHA: true,\n ifMeta: true,\n ifLog: true,\n ifGlobal: true,\n }),\n ],\n});","lang":"typescript","description":"Minimal setup for Vite: enables short git SHA, meta tags, console log, and global variable injection."},"warnings":[{"fix":"Replace 'ifGitSHA: true' with 'ifShortSHA: true' in plugin config.","message":"The 'ifGitSHA' option was deprecated in v0.0.12; use 'ifShortSHA' instead.","severity":"deprecated","affected_versions":"<0.0.12"},{"fix":"Migrate single 'command' string to new format: e.g., { commands: [{ command: 'git rev-parse --short HEAD', alias: 'sha' }] }.","message":"In v0.2.0, the 'command' option was replaced by multi-command support using an object or array format.","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Access global variable like `__APP_VERSION__` after DOMContentLoaded if needed.","message":"The global variable is injected via a script tag in the HTML (since v0.1.3).","severity":"gotcha","affected_versions":">=0.1.3"},{"fix":"Ensure Nuxt 3.3+ is installed in your project.","message":"Nuxt module requires @nuxt/kit and @nuxt/schema >3.3.0 as peer dependencies.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Upgrade to v0.1.1+ or use a custom plugin to write version file.","message":"The 'outputFile' option was added in v0.1.1; older versions have no file output support.","severity":"deprecated","affected_versions":"<0.1.1"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use `import { nuxtModule } from 'vite-plugin-version-mark/nuxt'` or load as module in nuxt.config.","cause":"Importing nuxt module from the main package path instead of subpath.","error":"Failed to load url /@vite-plugin-version-mark/nuxt (resolved id: /@vite-plugin-version-mark/nuxt)"},{"fix":"Use named import: `import { vitePluginVersionMark } from 'vite-plugin-version-mark'`.","cause":"Attempting to import the plugin as default export.","error":"Module '\"vite-plugin-version-mark\"' has no default export"},{"fix":"Ensure the Vite/Nuxt config file is at the project root, or explicitly set 'name' and 'version' in plugin options.","cause":"The plugin cannot read package.json if the command is not run from the project root.","error":"TypeError: Cannot read properties of undefined (reading 'version')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}