Skip to content

Docs: integrate search with Pagefind instead of Algolia#42226

Draft
julien-deramond wants to merge 2 commits intov6-devfrom
v6-dev-jd-use-pagefind
Draft

Docs: integrate search with Pagefind instead of Algolia#42226
julien-deramond wants to merge 2 commits intov6-devfrom
v6-dev-jd-use-pagefind

Conversation

@julien-deramond
Copy link
Member

@julien-deramond julien-deramond commented Mar 22, 2026

Warning

Heavily draft

Description

This PR suggests to switch from Algolia to Pagefind; commonly used with Astro-based docs.

Checklist

  • Check configurations available in Pagefind for better results
  • Improve CSS rules for better rendering (current one is just a prototype)
  • Improve a11y
  • Clean up the branch (JS CSS, etc.)
  • Rendering with local build (npm run start)
  • Rendering with local build (npm run release ; npm run docs ; cd _site ; http-server)
  • Rendering with Netlify

package.json Outdated
"@babel/core": "^7.28.5",
"@babel/preset-env": "^7.28.5",
"@docsearch/js": "^3.9.0",
"pagefind": "^1.3.0",
Copy link
Member Author

@julien-deramond julien-deramond Mar 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could use https://github.com/shishkin/astro-pagefind as it was prototyped at #41842 instead but there's always the question of how long would it be maintained. If we can make it work without too much efforts directly with pagefind, I'd stick with this solution.

@julien-deramond julien-deramond force-pushed the v6-dev-jd-use-pagefind branch from 5de5cf0 to b93ffb0 Compare March 22, 2026 09:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Inbox

Development

Successfully merging this pull request may close these issues.

1 participant