JSPM

vite-plugin-office-addin

2.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3150
  • Score
    100M100P100Q136086F
  • License MIT

Office Add-ins development using Vite.

Package Exports

  • vite-plugin-office-addin
  • vite-plugin-office-addin/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vite-plugin-office-addin) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

vite-plugin-office-addin

Office Add-ins development using Vite.

Build your Office Add-in using Vite. This plugin adds the support for manifest.xml file to be copied to build output.

Getting Started

Install the vite-plugin-office-addin to your Office Add-in project.

# using npm
npm install --save-dev vite-plugin-office-addin

# using yarn
yarn add vite-plugin-office-addin -D

Configure Vite

Use the plugin in your vite.config.js file:

// vite.config.js
import { defineConfig } from 'vite'
import officeAddin from 'vite-plugin-office-addin'

export default defineConfig({
  plugins: [officeAddin()]
})

Advanced Usage

Replacing development address

To replace the development URL address in manifest.xml file to production address, you can use the plugin configuration option or .env files.

// vite.config.js
import { defineConfig } from 'vite'
import officeAddin from 'vite-plugin-office-addin'

export default defineConfig({
  plugins: [officeAddin({
    devUrl: 'https://localhost:3000',
    prodUrl: 'https://office-addin.contoso.com'
  })]
})

Alternatively, you can use .env to replace different addresses for different environments. Use the ADDIN_DEV_URL and ADDIN_PROD_URL environment variables.

// vite.config.js + .env files
import { defineConfig } from 'vite'
import officeAddin from 'vite-plugin-office-addin'

export default defineConfig({
  plugins: [officeAddin()]
})
# .env.production
ADDIN_DEV_URL=https://localhost:3000
ADDIN_PROD_URL=https://office-addin.contoso.com

When you run vite build the generated manifest.xml file will have production addresses.

Specify a custom path

If your manifest.xml file is not in the project root, set the path property to point to the right location:

// vite.config.js
import { defineConfig } from 'vite'
import officeAddin from 'vite-plugin-office-addin'

export default defineConfig({
  plugins: [officeAddin({
    path: 'src/other-folder/manifest.xml'
  })]
})

Copying multiple manifests

To copy multiple manifests to your output folder, define officeAddin entry for each file:

// vite.config.js
import { defineConfig } from 'vite'
import officeAddin from 'vite-plugin-office-addin'

export default defineConfig({
  plugins: [
    officeAddin({ path: 'manifest.xml' }),
    officeAddin({ path: 'manifest.staging.xml' }),
  ]
})

License

Licensed under MIT License.
Copyright © 2021 Jozef Izso