Gatsby build fails due to server-side rendering localStorage error

[Amirbeek]

Preliminary Checks

• This issue is not a duplicate. Before opening a new issue, please search existing issues: https://github.com/gatsbyjs/gatsby/issues
• This issue is not a question, feature request, RFC, or anything other than a bug report directly related to Gatsby. Please post those things in GitHub Discussions: https://github.com/gatsbyjs/gatsby/discussions

Description

I encountered an error when running gatsby build. I tried all the recommended solutions, but none of them helped. The issue seems to be related to server-side rendering (SSR) and localStorage.

Steps to Reproduce:

Run gatsby build
Observe the error related to localStorage
Expected Behavior:
The build should complete successfully without SSR-related localStorage issues.

Actual Behavior:
The build fails with an error mentioning localStorage, which is not available in the server-side environment.

Attempted Solutions:

Followed all suggested fixes in the documentation and community forums.
Ensured localStorage is only accessed on the client side.
Tried wrapping localStorage calls in useEffect.

Reproduction Link

https://github.com/Amirbeek/SEO-Gatsby-template

Steps to Reproduce

...

Expected Result

The gatsby build command should complete successfully without errors. The built site should function correctly, and there should be no issues related to localStorage during server-side rendering.

Actual Result

The gatsby build process fails with an error related to localStorage. Since localStorage is not available in the server-side environment, Gatsby throws an error during server-side rendering (SSR).

Environment

Gatsby Version: 5.14.1
Node.js Version: Run node -v to check
Operating System: Run uname -a (Linux/macOS) or systeminfo (Windows) to check

Config Flags

No response