This repository contains utilities for building a FiftyOne JS plugin.

You can find a hello world JS plugin in the @voxel51/hello-world-plugin-js repo.

The build utilities are designed to be as simple as possible. The main goal is to provide a single function that can be called to get a Vite config object that can be used to build a JS plugin. The function takes in the path to the plugin's directory and an optional object that can be used to override the default Vite config.

This repo uses ESM but it's transpiled to both ESM and CommonJS so it can be used in both ESM and CommonJS projects.

All pacakges declared in the dependecies of your plugin's package.json are externalized, except for packages starting with @fiftyone/, @mui/material, recoil, react, react-dom, and styled-components. This is because these packages are expected to be provided by the host application.

Note: if you encounter problems with @mui/material, you can bundle it in by setting opts.forceBundleMui. Doing this might have consequences on the theming of the plugin, so it's recommended to avoid it if possible.