{"id":22890,"library":"vite-plugin-translate","title":"vite-plugin-translate","description":"Vite plugin that integrates translate.js for automatic website translation. Current stable version is 0.0.6, with initial release in 2024. It handles bundling the translate.js library, emitting it to the build output with version/timestamp in filename, and injecting script tags into HTML. Supports translate.js versions 3.18.66 and 4.0.3. Optionally injects an initialization script after translate.js loads. Requires Vite >=5 as a peer dependency. Ships TypeScript types.","status":"active","version":"0.0.6","language":"javascript","source_language":"en","source_url":"https://github.com/hackycy-collection/translation-master","tags":["javascript","typescript"],"install":[{"cmd":"npm install vite-plugin-translate","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-translate","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-translate","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Named export, not default export.","wrong":"import ViteTranslatePlugin from 'vite-plugin-translate'","symbol":"ViteTranslatePlugin","correct":"import { ViteTranslatePlugin } from 'vite-plugin-translate'"},{"note":"PluginOptions is a type, so use `import type` in TypeScript.","wrong":"import { PluginOptions } from 'vite-plugin-translate'","symbol":"PluginOptions","correct":"import type { PluginOptions } from 'vite-plugin-translate'"},{"note":"CJS usage: destructure the named export, not .default.","wrong":"const ViteTranslatePlugin = require('vite-plugin-translate').default","symbol":"require","correct":"const { ViteTranslatePlugin } = require('vite-plugin-translate')"}],"quickstart":{"code":"import { defineConfig } from 'vite'\nimport { ViteTranslatePlugin } from 'vite-plugin-translate'\n\nexport default defineConfig({\n  plugins: [\n    ViteTranslatePlugin({\n      version: '4.0.3',\n      initializeScript: `\n        translate.language.setLocal('english');\n        translate.execute();\n      `,\n    }),\n  ],\n})","lang":"typescript","description":"Integrates translate.js into a Vite project with version and initialization script."},"warnings":[{"fix":"Remove `injectTo` from plugin options. The plugin now injects script tags in a fixed manner.","message":"In v0.0.5, the `injectTo` option was removed. If you were using it, your config will fail silently (no error).","severity":"breaking","affected_versions":"<=0.0.4"},{"fix":"No action required yet, but watch for changelogs.","message":"The `initializeScript` option may be deprecated in future versions. The plugin currently injects it as a second script tag.","severity":"deprecated","affected_versions":">=0.0.6"},{"fix":"Ensure you pass a supported version string to the `version` option.","message":"Plugin only works with translate.js versions 3.18.66 and 4.0.3. Unsupported versions will cause runtime errors.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Upgrade Vite to version 5 or higher.","message":"The plugin depends on Vite >=5. Using it with Vite 4 or earlier will result in a peer dependency warning and potential incompatibility.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"If you need custom script injection, consider forking the plugin or using a different approach.","message":"The plugin injects scripts into the HTML automatically; disabling or overriding this may require advanced configuration.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Add `version: '4.0.3'` (or another supported version) to the plugin options.","cause":"Missing or undefined version option in plugin configuration.","error":"Error: The 'version' option is required for ViteTranslatePlugin"},{"fix":"Use `const { ViteTranslatePlugin } = require('vite-plugin-translate')`.","cause":"Using CommonJS require with default import syntax instead of destructuring.","error":"Cannot find module 'vite-plugin-translate' when using require()"},{"fix":"Use `import { ViteTranslatePlugin } from 'vite-plugin-translate'`.","cause":"Importing as default export instead of named export.","error":"TypeError: ViteTranslatePlugin is not a constructor"},{"fix":"Ensure `initializeScript` is set and that it runs after the library loads (the plugin handles this automatically).","cause":"Initialization script runs before translate.js is fully loaded.","error":"Uncaught ReferenceError: translate is not defined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}