Skip to content

fix(sitemap): include statically-generated toolkit pages#971

Draft
teallarson wants to merge 2 commits into
mainfrom
fix/sitemap-toolkit-routes
Draft

fix(sitemap): include statically-generated toolkit pages#971
teallarson wants to merge 2 commits into
mainfrom
fix/sitemap-toolkit-routes

Conversation

@teallarson
Copy link
Copy Markdown
Contributor

Summary

Toolkit pages at /en/resources/integrations/{category}/{toolkitId} were missing from sitemap.xml because the filesystem walk in app/sitemap.ts skips directories whose names contain [, dropping all [toolkitId] dynamic route folders. This means search engines get no direct signal to crawl ~100 toolkit pages.

  • Adds a buildSitemap() helper that runs the MDX walk and listToolkitRoutes() in parallel, then merges, deduplicates, and sorts the results
  • Excludes the others category (no on-disk route, redirected by next.config.ts)
  • Updates tests/sitemap.test.ts to assert a known toolkit URL is present, >10 integration URLs exist, and no [ placeholder leaks

Related

  • Closes TOO-736 (partial — the Algolia attributeForDistinct config change is being applied separately in the crawler dashboard)
  • Revives the fix from closed PR fix(sitemap): include generated toolkit pages #923 in a simplified form (no per-toolkit lastModified lookup to keep it lean)

Test plan

  • CI green
  • After deploy, confirm https://docs.arcade.dev/sitemap.xml contains /en/resources/integrations/development/github and other toolkit URLs

Toolkit pages at /en/resources/integrations/{category}/{toolkitId} were
excluded from the sitemap because the filesystem walk skips directories
whose names contain "[". This means search engines had no direct signal
to crawl them.

Uses the existing listToolkitRoutes() helper to append toolkit URLs after
the MDX walk, deduplicates across both sources, and excludes the "others"
category which has no on-disk route.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 14, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 14, 2026 6:11pm

Request Review

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

1 participant