When dealing with third-party modules that use window
in Gatsby you need to add a null
loader to its own webpack configuration to avoid the transpilation during the SSR (Server-Side Rendering). This is because gatsby develop
occurs in the browser (where there is a window
) while gatsby build
occurs in the Node server where obviously there isn’t a window
or other global objects (because they are not even defined yet).
exports.onCreateWebpackConfig = ({ stage, loaders, actions }) => {
if (stage === "build-html") {
actions.setWebpackConfig({
module: {
rules: [
{
test: /react-particle-animation/,
use: loaders.null(),
},
],
},
})
}
}
Keep in mind that the test
value is a regular expression that will match a folder under node_modules
so, ensure that the /react-particle-animation/
is the right name.
Using a patch-package may work but keep in mind that you are adding an extra package, another bundled file that could potentially affect the performance of the site. The proposed snippet is a built-in solution that is fired when you build your application.