Custom bundle

You can simply make custom bundles yourself, if none of the distributed packages meet your needs, or you want to make a more optimized bundle file with/without specific traces and transforms.

Make sure you have the versions of node/npm that's recommended:

plotly.js before 2.5: Node 12/npm 6
plotly.js from 2.5: Node 16/npm 8
plotly.js from 2.35: Node 18/npm 10

To download a specific node version look here.

Note: For CI, it's faster to do git clone --depth 1 to only get one commit.

Clone plotly.js, where the is one of these:

git clone --branch <version> https://github.com/plotly/plotly.js.git

Note: If you've already cloned plotly.js, then could switch to another version with:

git fetch
git checkout <version>

Move to plotly.js folder then install plotly.js dependencies:

cd plotly.js
npm i

By default all traces and transforms are included in the bundle if you simply run:

npm run custom-bundle

Use the traces option to include just the trace types you need.

npm run custom-bundle -- --traces scatter,scattergl,scatter3d

Please note that the scatter trace is currently included in all bundles and cannot be removed. This behaviour may change in the future, so we recommend that you explicitly include scatter anyway if you need it in your bundle.

Use the transforms option to specify which should be included.

npm run custom-bundle -- --transforms sort,filter

Or use transforms none to exclude them all.

npm run custom-bundle -- --transforms none

Use the strict option to use strict trace types where possible.

npm run custom-bundle -- --traces scatter,scattergl --strict

Use the out option to change the bundle filename (default custom). The new bundle will be created in the dist/ directory and named plotly-<out>.min.js or plotly-<out>.js if unminified.

npm run custom-bundle -- --out myBundleName

Use the unminified option to disable compression.

npm run custom-bundle -- --unminified

Example illustrating use of different options together

To create an unminified custom bundle named myScatters including scatter, scattergl and scatter3d traces without any transforms:

npm run custom-bundle -- \
    --unminified \
    --out myScatters \
    --traces scatter,scattergl,scatter3d \
    --transforms none

Or simply on one line:

npm run custom-bundle -- --unminified --out myScatters --traces scatter,scattergl,scatter3d --transforms none

Uh oh!