netlify-plugin-gatsby

3.4.0 (2022-07-25)

Features

• handle number and object responses correctly in functions (#440) (2335f5e)

3.3.1 (2022-07-15)

Bug Fixes

• add fs.promises to linked filesystem (#441) (d5be3cc)

3.3.0 (2022-07-13)

Features

• do not pre-warm lambdas if DEPLOY_PRIME_URL is not set (#435) (9c0e8ba)

3.2.5 (2022-07-11)

Bug Fixes

• support scoped names for platform binary packages in lmdb (#431) (a34b1aa)

3.2.4 (2022-06-24)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.1.2 (#413) (6838df8)

3.2.3 (2022-06-23)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.1.1 (#410) (40dbcde)

3.2.2 (2022-06-13)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.1.0 (#399) (8ae84c7)

3.2.1 (2022-06-01)

Bug Fixes

• add AbortController polyfill (#391) (db412a2)
• fix downloadUrl when downloading Gatsby datastore file from CDN (#392) (b455188)

3.2.0 (2022-05-30)

Features

• Optionally load gatsby datastore in lambdas (#376) (1c0fcea)

Bug Fixes

• deps: update dependency pathe to ^0.3.0 (#370) (e283ff8)

3.1.0 (2022-05-19)

Features

• enable API, SSR and DSG functions individually as required (#375) (aa36bc2)

Bug Fixes

• deps: update dependency cookie to ^0.5.0 (#356) (40f0f85)
• deps: update dependency fs-extra to v10.1.0 (#357) (c0c9bfc)
• deps: update dependency semver to v7.3.6 (#347) (93d951b)
• deps: update dependency semver to v7.3.7 (#354) (a3f9b23)

3.0.0 (2022-04-04)

Version 3 of the Essential Gatsby build plugin improves DSG handling and moves it to netlify/gatsby-plugin-netlify, which means version 4.2.0 of that plugin is now a requirement for sites with SSR/DSG pages.

⚠ BREAKING CHANGES

• remove catch-all DSG redirect and handle discretely (#334)

Bug Fixes

• remove catch-all DSG redirect and handle discretely (#334) (21773dd)

2.1.4 (2022-03-21)

Bug Fixes

• resolve lmdb binaries correctly (#327) (c6c162b)

2.1.3 (2022-03-16)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.0.1 (#318) (f9e7a88)
• patch new lmdb binary location (#322) (0abc3f9)

2.1.1 (2022-03-02)

Bug Fixes

• update image CDN docs and defaults (#307) (0a7b223)

2.1.0 (2022-03-02)

Features

• add support for /_gatsby/file/* redirects (#305) (d071712)
• image cdn support (#303) (77b5aa4)

Bug Fixes

• deps: update dependency fs-extra to v10.0.1 (#299) (2e0c8fb)

2.0.4 (2022-02-23)

Bug Fixes

• remove confusing error log (#292) (ed5ab59)

2.0.3 (2022-02-21)

Bug Fixes

• deps: update dependency @netlify/functions to ^0.11.1 (#279) (f2272b9)
• deps: update dependency @netlify/functions to v1 (#280) (e9faecc)
• deps: update dependency cookie to v0.4.2 (#263) (d031e20)
• support gatsby base dirs outside the site root (#281) (ccbec68)

What's Changed

• fix: ensure lmdb correct binaries are available for lambdas by @ascorbic in https://github.com/netlify/netlify-plugin-gatsby/pull/253

Full Changelog: https://github.com/netlify/netlify-plugin-gatsby/compare/v2.0.1...v2.0.2

What's Changed

• fix: correct publish file by @ascorbic in https://github.com/netlify/netlify-plugin-gatsby/pull/249

Full Changelog: https://github.com/netlify/netlify-plugin-gatsby/compare/v2.0.0...v2.0.1

Version 2 of the Essential Gatsby build plugin adds support for the new render modes introduced in Gatsby 4, as well as improved support for Gatsby functions. For best results it should be installed alongside gatsby-plugin-netlify. Beta support was available since Gatsby 4 was released, but with this stable release it is ready for production use for everyone.

Features

This version adds full support for the new Gatsby 4 render modes on Netlify. Gatsby 4 introduced two render modes, alongside its original SSG mode. For a detailed comparison of each mode see this blog post.

To support these new modes, the Essential Netlify build plugin generates three serverless Netlify Functions that are automatically deployed alongside your site:

• __api: used for Gatsby Functions
• __dsg: an on-demand builder used for DSG pages.
• __ssr: used for server-side rendered pages.

You do not need to configure or deploy these functions yourself: they are automatically generated and deployed whenever you build.

You can see the logs for these functions in the "Functions" tabs in the Netlify dashboard.

It will also generate Netlify rewrites to ensure that each route is handled by the correct function.

Installing

This version of the plugin will soon be installed automatically for all Gatsby sites on Netlify. If you can't wait, you can install it manually using file-based plugin installation.

You should also install gatsby-plugin-netlify to enable all features. It is required if you are using SSR pages. See how to install

Deploying your site

You do not need to do anything different to deploy your site if building on Netlify: it will automatically deploy the functions when you build. If you are deploying manually using the Netlify CLI, you must ensure that instead of running netlify build then netlify deploy as separate commands, you run them together as netlify deploy --build.

Caveats

Currently you cannot use StaticImage or gatsby-transformer-sharp in SSR or DSG pages. The best workaround is to use an image CDN such as Cloudinary or imgix to host your images. This will give you faster builds too.

Feedback

If you have feedback or bug reports, join the discussion or open an issue