Netlify Build plugin - Run Gatsby seamlessly on Netlify
npm install @netlify/plugin-gatsby!Netlify Build plugin Gatsby – Run Gatsby seamlessly on Netlify
The Essential Gatsby build plugin enables caching of builds, SSR and DSG
render modes,
image CDN and Gatsby Functions. It is installed automatically for all new Gatsby
sites.
> Note:
>
> - Essential Gatsby includes functionality from the
> Gatsby Cache build plugin.
> If you already have the Gatsby Cache plugin installed on your Netlify site,
> you should
> remove it
> before installing this plugin.
> - Essential Gatsby is not compatible with the Gatsby community plugin
> gatsby-plugin-netlify-cache.
Gatsby sites need two plugins to support all features.
1. The Netlify build plugin, called "Essential Gatsby" or
@netlify/plugin-gatsby. This is installed automatically for all Gatsby
sites deployed to Netlify.
2. The Gatsby plugin gatsby-plugin-netlify. This needs to be manually
installed.
New Gatsby sites on Netlify automatically install the Essential Gatsby build
plugin. You can confirm this in the build logs. If you need to install it
manually, you have two options:
- The Netlify UI.
Here, you can search for "Essential Gatsby" and install the plugin.
- File-based plugin installation.
You can install the plugin as @netlify/plugin-gatsby in your netlify.toml
file.
You should also install the Gatsby plugin
gatsby-plugin-netlify.
This is required for SSR and DSG pages, and adds support for Gatsby redirects and asset
caching rules:
1. Add the package as a dependency:
``shell`
npm install -D gatsby-plugin-netlify
2. Then add the following to your gatsby-config.js file:
`js`
module.exports = {
plugins: ['gatsby-plugin-netlify'],
}
See
the gatsby-plugin-netlify docs
for more information, including optional plugin configuration.
In order to support Gatsby Functions and DSG and SSR render modes, this plugin
generates four Netlify Functions called __api, __ssr, __dsg and _ipx. Ifgatsby-plugin-netlify
you are not using any of these modes, then you can disable the creation of these
functions. If you are using the latest version of thenNETLIFY_SKIP_GATSBY_FUNCTIONS
this will be handled automatically, disabling functions if the site has no
Gatsby Functions, or DSG/SSR pages. Otherwise, you can do this manually by
setting the environment variable to true. Be
aware that if you do this, any DSG or SSR pages will not work, and nor will any
Gatsby Functions or the remote image CDN.
Gatsby includes beta support for deferred image resizing using a CDN. Netlify
includes full support for Image CDN on all plans. For details on how to enable
it, see
the image CDN docs.
Currently you cannot use StaticImage or gatsby-transformer-sharp in SSR or
DSG pages. Support for Gatsby Image CDN is coming soon. The best workaround is
to use an image CDN such as
Cloudinary
or imgix to host your images. This will give
you faster builds and rendering too.
When developing Gatsby Functions it is usually easier to use the built-in
gatsby develop functions server. However if you want to try the Netlifynetlify dev
functions wrapper it will run via . You should be sure to runnetlify build first, so that the wrappers are generated and the functions
copied across.
In order to use Netlify Background or Netlify Scheduled Functions in your Gatsby project, you will need to create a netlify/functions` directory at the root of the project, and put the Functions in there.
Once that's completed, the Background or Scheduled Function can be invoked like an ordinary Gatsby function.