[CHORE] Add SCHEMA_PREVIEW build mode + misc. fixes for publishing

[John McCall (lowlydba)]

This is groundwork to enable both the schema and docs repos to build branch deploy previews that contain each others' latest content (https://github.com/OvertureMaps/schema-wg/issues/416). This PR must be merged before that one can be updated and made ready to land.

After merging, docs preview builds will automagically include the latest schema docs (dev branch) and deploy a version using the local schema documents from the repository. This is to allow easy A/B testing until we have full confidence in the auto-generated docs.

The production deploy will still use the local schema/reference/* docs to build.

Changes

Docusaurus configuration improvements

• Added support for a SCHEMA_PREVIEW environment variable in docusaurus.config.js to enable building a schema-only preview, which disables blog, community pages, and unrelated navbar items for faster, focused previews.
  • This is required for [FEATURE] Docs preview for schema changes schema#473
• Set onBrokenAnchors: 'throw' in the Docusaurus config to fail builds on broken anchors, improving documentation quality.
  • Broken anchor links were also fixed as part of this
• Changed the HeroSubtext component in home.jsx from a <p> to a <div> to silence an orphan </p> warning from Docusaurus
• Set onBrokenRoutes: 'throw' in the Docusaurus config to fail builds on duplicate routes.
  • Fixed the existing duplicate path for docs/guides/places by renaming the dev-centric README to _README so Docusaurus omits it from its build

CI workflow and dependency management updates

• Added npm dependency management to Dependabot configuration for automated updates, with custom labels and commit message formatting.
• Updated CI workflows to set up Node.js using the version specified in package.json and integrated the sustainable-npm action to ensure sustainable (read: fast) package installations in CI
• Updated the required Node.js version in package.json to >=24 for compatibility with newer dependencies and workflows (Node 20 is soon EOL in GitHub)
• Removed the unused yaml-loader dev dependency from package.json.

Partially resolves https://github.com/OvertureMaps/schema-wg/issues/416

[github-actions]

Super-linter summary

Language	Validation result
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
SQLFLUFF	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

🗺️ OMF Docs previews are live!

🆕 Auto-gen schema site (beta)	https://staging.overturemaps.org/docs/pr/297/index.html
🗂️ Auto-gen schema ref	dev@ac45fe7
🌍 Repo schema site	https://staging.overturemaps.org/docs/pr/297-no-autogen/index.html
🕐 Updated	Mar 18, 2026 21:05 UTC
📝 Commit	7aaf415

Auto-gen schema site is now available. This is an early preview of a future workflow where we will automatically generate and publish reference docs for the Overture Maps Format schema with every change to the schema repo.
The auto-gen schema site may contain incomplete or inaccurate information as we are still refining the generation process, so please compare against the repo schema site and refer to the linked commit for the most up-to-date source of truth.

Note

♻️ This preview updates automatically with each push to this PR.

[github-actions]

Super-linter summary

Language	Validation result
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
SQLFLUFF	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
SQLFLUFF	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[github-actions]

Super-linter summary

Language	Validation result
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
SQLFLUFF	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Dana Bauer (danabauer)]

Bombs away!