{"id":22762,"library":"vite-plugin-office-addin","title":"vite-plugin-office-addin","description":"Vite plugin for Office Add-in development. Copies and transforms manifest.xml during Vite builds. Latest version 2.1.0 supports Vite 4/5 and Node 18+. Provides dev-to-prod URL replacement via options or .env variables. Allows custom manifest paths and multiple manifest copying. Ships TypeScript types. Released under MIT.","status":"active","version":"2.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/jozefizso/vite-plugin-office-addin","tags":["javascript","vite","vite-plugin","office-addin","typescript"],"install":[{"cmd":"npm install vite-plugin-office-addin","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-office-addin","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-office-addin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency - plugin requires Vite >=4.5.0","package":"vite","optional":false}],"imports":[{"note":"Default export only.","wrong":"import { officeAddin } from 'vite-plugin-office-addin'","symbol":"default","correct":"import officeAddin from 'vite-plugin-office-addin'"},{"note":"Type import; only available if using TypeScript.","wrong":"import { OfficeAddinPluginOptions } from 'vite-plugin-office-addin'","symbol":"OfficeAddinPluginOptions","correct":"import type { OfficeAddinPluginOptions } from 'vite-plugin-office-addin'"},{"note":"CommonJS require must access .default property due to ESM default export.","wrong":"const officeAddin = require('vite-plugin-office-addin')","symbol":"require","correct":"const officeAddin = require('vite-plugin-office-addin').default"}],"quickstart":{"code":"// vite.config.js\nimport { defineConfig } from 'vite'\nimport officeAddin from 'vite-plugin-office-addin'\n\nexport default defineConfig({\n  plugins: [officeAddin()]\n})","lang":"javascript","description":"Basic setup: import default export and add to vite plugins array."},"warnings":[{"fix":"Upgrade Vite to >=4.5.0 and Node to >=18.0.0.","message":"Version 2.0.0 dropped support for Vite 2/3 and Node 14/16. Only Vite 4/5 and Node 18/20 supported.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Configure with `officeAddin({ path: 'src/other-folder/manifest.xml' })`.","message":"Plugin only copies manifest.xml from project root by default. If your manifest is elsewhere, you must set the `path` option.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use `const officeAddin = require('vite-plugin-office-addin').default`.","message":"CommonJS require pattern: `const officeAddin = require('vite-plugin-office-addin')` returns a module with default property; using it directly as a plugin will cause Vite to throw an error.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Update Node.js to version 18 or 20.","message":"Node 14 and 16 are no longer supported as of v2.0.0.","severity":"deprecated","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Specify the correct path: `officeAddin({ path: 'src/manifest.xml' })`","cause":"manifest.xml not found at default path (project root).","error":"Error: The service is unavailable. Try again later. If the problem persists, contact your administrator."},{"fix":"Use `const officeAddin = require('vite-plugin-office-addin').default`","cause":"CommonJS require without accessing .default.","error":"TypeError: officeAddin is not a function"},{"fix":"Upgrade Vite to >=4.5.0 or downgrade plugin to v1.x.","cause":"Installed version 2.x with an older Vite.","error":"Error: [vite] The plugin 'vite-plugin-office-addin' requires at least Vite 4.5.0."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}