Replace Algolia search with Pagefind - #963
Draft
mtthwcmpbll wants to merge 1 commit into
Draft
Conversation
…s, and ensure that recipe options are searchable
mtthwcmpbll
marked this pull request as draft
August 20, 2026 20:52
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Swaps the search engine from Algolia to Pagefind, which indexes the rendered HTML at build time and runs entirely in the browser — no search service, API key, or crawler. The modal keeps DocSearch's markup, class names, and stylesheet (vendored from
@docsearch/css@4.6.3), so the UI, keyboard shortcuts, facet tabs, and recent/favourite searches are unchanged;@docusaurus/theme-search-algolia,@docsearch/react,algoliasearch, andsearch-insightsare all gone, along with the theme's/searchpage, which is reimplemented insrc/pages/search.tsx.Recipe results now show the recipe ID instead of the generated excerpt, since recipes share display names across languages (three unrelated recipes are all called "Module has dependency") and their excerpts are identical boilerplate. Option names in
OptionsTableare weighted in the index, so searching an option surfaces the recipes that actually take it — previously the top hit formethodPatterndidn't declare it at all; now all of the top 10 do.Indexing runs in
postBuildforyarn build, and in the sharded CI build it stands down per-shard and runs against the merged output in thecombinejob.yarn startserves the last build's index, and reports clearly when there isn't one.Two notes for reviewers: the "Powered by Algolia" footer logo is necessarily gone (keyboard hints pinned in place with a CSS override), and Algolia search analytics go away with it. The vendored stylesheet is pinned first in
customCss— order is load-bearing, since DocSearch's.DocSearch-Button { all: unset }would otherwise wipe out custom.css's Morpheus restyle.Verified: full build (8,635 pages indexed),
tsc,validate:css, andknipclean, plus 21 new tests covering the Pagefind adapter and modal. The one failing test (filterUtils) fails onmaintoo.