@aldiand/vite-plugin-office-addin/README.md

Office Add-ins development using Vite.

# 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.

```sh
# 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:

```js
// vite.config.js
import officeAddin from 'vite-plugin-office-addin'

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

### Advanced Usage

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

```js
// vite.config.js
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.

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

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

```sh
# .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.

## License

Licensed under [MIT License](LICENSE).  
Copyright © 2021 Jozef Izso