v3.1 Release Notes
Welcome to gatsby@3.1.0 release (March 2021 #2)
Key highlights of this release:
Also check out notable bugfixes.
Bleeding Edge: Want to try new features as soon as possible? Install gatsby@next and let us know
if you have any issues.
Fast Refresh Dark Mode
Gatsby’s Fast Refresh modal now respects the prefers-color-scheme setting from your operating system. Depending on your setting you’ll see the overlay in light or dark mode — which is great because it makes the modal more accessible!
Improved Error Messages
We’ve seen many complaints about the unspecific error "Error page resources for <path> not found. Not rendering React". There are many reasons why this could happen so we improved our error logging to output the original error. As usual you’ll see the error in DevTools console or in your error tracker.
Consider the following example, it now shows the actual error.
In development mode we also now show the original error when it occurs in gatsby-browser.js or outside of React components.
Contentful gatsbyImageData is stable
Contentful now fully supports gatsby-plugin-image out of the box. You can find the official docs for gatsby-plugin-image in gatsby-source-contentful the official contentful plugin docs
You can find more information on how to switch to gatsby-plugin-image by going to our gatsby-image to gatsby-plugin-image migration guide
Notable bugfixes
- gatsby: Fix routing when path starts with @ symbol, via PR #29935
- gatsby: Fix incremental builds when remove trailing slashes is used, via PR #29953
- gatsby: Add build stage to custom babel-preset-gatsby configurations, via PR #30047
- gatsby: Fix hanging Gatsby process between webpack rebuilds in development, via PR 30127
- gatsby: fix SitePage schema, via PR #30132
- gatsby: fix double save during gatsby develop, via PR #30193
- gatsby-plugin-image: Handle placeholder in plugin toolkit correctly, via PR #30141
- gatsby-source-contentful: fix deprecation warnings, via PR #29675
Contributors
visualfanatic: docs(gatsby-plugin-subfont): correct property name PR #29803
chrsep: fix: query on demand loading indicator always active on preact. PR #29829
imshubhamsingh: chore(docs): updated doc for payment using square PR #27272
ahmetcanaydemir: fix(gatsby-react-router-scroll): debounce function for scrollListener PR #26933
talohana: chore(docs): add paths to unit-testing using typescript PR #28029
hashimwarren: chore(docs): Update headless WordPress article PR #29402
lorensr: chore(docs): Add twitter links to tutorial PR #29696
herecydev: fix(gatsby): Add dir=ltr to Fast Refresh overlay PR #29900
dan2k3k4: chore(docs): Fix link to /docs/conceptual/using-gatsby-image PR #29930
lourd: refactor(gatsby-transformer-remark): Refactors out Bluebird usage in transformer-remark PR #29638
ahollenbach: docs: clarify env variable prefix in gatsby-source-filesystem docs PR #30013
Swarleys: docs(gatsby-plugin-image): fixing a typo. PR #29994
samlogan: fix(gatsby-plugin-image): broken documentation links PR #30065
KarlBaumann: chore(gatsby-source-wordpress): Remove version from README PR #30056
Vazerthon: chore(docs): Add link to art direction docs PR #30041
magnusdahlstrand: chore(gatsby-plugin-postcss): Update README to show correct usage PR #30035
feedm3: chore(docs): set process polyfill correctly PR #30160
machadoluiz: fix(docs): update conceptual gatsby image doc PR #30175
dhrumilp15: chore(docs): Update deploying-to-digitalocean-droplet PR #30161