Skip to content

Netlify Deploy Error: Gatsby Plugin Incompatibility with Project Version#47

Open
netlify-coding[bot] wants to merge 1 commit intomasterfrom
agent-with-project-version-7e94
Open

Netlify Deploy Error: Gatsby Plugin Incompatibility with Project Version#47
netlify-coding[bot] wants to merge 1 commit intomasterfrom
agent-with-project-version-7e94

Conversation

@netlify-coding
Copy link

@netlify-coding netlify-coding bot commented Feb 5, 2026

🔗 View agent run: https://app.netlify.com/projects/sfdharmacollective/agent-runs/6985108786a6b2deb4ad7e94

🤖 Agent: Claude

💬 Prompt: The Netlify deploy errored, with the following guidance provided:

Diagnosis

  • The build fails because installed Gatsby plugins are incompatible with the Gatsby version used by the project. The logs show plugin-version/API mismatch: e.g. gatsby-plug...

Result: The Netlify deploy was failing because three Gatsby plugins had been upgraded to versions incompatible with the project's Gatsby v2 (2.32.13) runtime. Specifically, gatsby-plugin-sharp@^4.0.0, gatsby-plugin-manifest@^4.0.0, and gatsby-plugin-postcss@^5.5.0 all required Gatsby v3 or v4, which caused plugin API mismatches (e.g., the onPluginInit API not existing in Gatsby v2) and a different GraphQL schema that removed the tracedSVG image field.

These plugins were downgraded to the latest versions compatible with Gatsby v2:

  • gatsby-plugin-sharp: ^4.0.0 to ^2.14.0 (resolved to 2.14.4)
  • gatsby-plugin-manifest: ^4.0.0 to ^2.12.0 (resolved to 2.12.1)
  • gatsby-plugin-postcss: ^5.5.0 to ^3.5.0 (resolved to 3.5.0 -- the v3.x line is the bridge release that supports both Gatsby v2 and PostCSS 8, which is required by the project's TailwindCSS v3 dependency)

Additionally, the GraphQL query in src/pages/about-us/teachers.js was updated to use the GatsbyContentfulFixed_withWebp fragment instead of GatsbyContentfulFixed_tracedSVG. The tracedSVG placeholder is not supported by the Contentful Images API used by gatsby-source-contentful and was returning HTTP 400 errors during static query execution. The _withWebp fragment is consistent with what the rest of the codebase already uses for Contentful images.

The yarn.lock file was regenerated from scratch to ensure all dependency resolutions are consistent with the corrected version ranges.

The full build (gatsby build && netlify-lambda build src/******) was verified to complete successfully after these changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants