From cff98ab68307c7e5d656b214091df7f9b4617709 Mon Sep 17 00:00:00 2001
From: Lukas Heumos <lukas.heumos@posteo.net>
Date: Sun, 23 Aug 2026 23:03:57 +0200
Subject: [PATCH 1/3] Add site-wide search

Pagefind indexes the built HTML after hugo runs, which matters here because the
ecosystem grid and the tutorial cards are rendered by layouts from remote JSON
rather than living in content files, so anything reading the markdown would miss
the 120 packages and 23 tutorials that people most want to find.

The dialog opens from the nav, from / and from ctrl+k, and is driven with the
arrow keys and enter. Results are filtered before display: Pagefind matches when
an indexed word is a prefix of the search term, so "xylophone" otherwise came
back matching "x" on seventeen pages.

Closes #269

Signed-off-by: Lukas Heumos <lukas.heumos@posteo.net>
---
 .github/workflows/gh-pages.yml |   3 +
 README.md                      |  10 +-
 assets/main.scss               | 146 ++++++++++++++++++++++++++++
 layouts/partials/footer.html   |   2 +-
 layouts/partials/header.html   |  31 +++++-
 netlify.toml                   |   5 +
 static/main.js                 | 170 +++++++++++++++++++++++++++++++++
 7 files changed, 364 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
index 8dc16698..adc3b555 100644
--- a/.github/workflows/gh-pages.yml
+++ b/.github/workflows/gh-pages.yml
@@ -25,6 +25,9 @@ jobs:
       - name: Build
         run: hugo --buildFuture --minify
 
+      - name: Build search index
+        run: npx --yes pagefind@1.5.2 --site public
+
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v4
         if: github.ref == 'refs/heads/main'
diff --git a/README.md b/README.md
index 4460cee8..c13794c2 100644
--- a/README.md
+++ b/README.md
@@ -24,5 +24,13 @@ Look inside [`/layout`](/layout) for that. [Hugo Templating](https://gohugo.io/t
 To build the website (with hot reload), [install Hugo](https://gohugo.io/getting-started/installing/) and run
 
 ```sh
-hugo server --buildFuture -D
+hugo server -D
+```
+
+Site search is powered by [Pagefind](https://pagefind.app/), which indexes the built HTML
+rather than the content files, so `hugo server` alone has no index and the search dialog
+will say so. To try it locally, build and index the site, then serve `public/`:
+
+```sh
+hugo && npx pagefind --site public && python3 -m http.server -d public
 ```
diff --git a/assets/main.scss b/assets/main.scss
index be29950e..3d7ec806 100644
--- a/assets/main.scss
+++ b/assets/main.scss
@@ -2781,3 +2781,149 @@ $eco-hues:
 .page-item-author {
     font-weight: 600;
 }
+
+// ---- Global search ------------------------------------------------------
+
+.nav-search-button {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    background: none;
+    border: 0;
+    color: $greyheader;
+    font-size: inherit;
+
+    &:hover {
+        color: $greyheaderhover;
+    }
+
+    .nav-search-kbd {
+        padding: 0.05rem 0.4rem;
+        border: 1px solid $tilebg2;
+        border-radius: 0.25rem;
+        background-color: $tilebg4;
+        color: $greydesc;
+        font-size: 0.75rem;
+        line-height: 1.2;
+
+        @media (max-width: 62rem) {
+            display: none;
+        }
+    }
+}
+
+.search-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: 1080;
+    display: flex;
+    justify-content: center;
+    padding: 4rem 1rem 1rem;
+    background-color: rgba(0, 0, 0, 0.45);
+
+    &[hidden] {
+        display: none;
+    }
+
+    @media (max-width: 50rem) {
+        padding: 1rem 0.5rem;
+    }
+}
+
+.search-dialog {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    max-width: 42rem;
+    max-height: 100%;
+    overflow: hidden;
+    border-radius: 0.75rem;
+    background-color: white;
+    box-shadow: 0 1.5rem 3rem rgba(0, 0, 0, 0.3);
+}
+
+.search-field {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 1rem 1.25rem;
+    border-bottom: 1px solid $tilebg;
+    color: $greydesc;
+}
+
+.search-input {
+    flex: 1;
+    border: 0;
+    outline: none;
+    font-size: 1.15rem;
+    color: $tiletext;
+
+    &::-webkit-search-cancel-button {
+        display: none;
+    }
+}
+
+.search-close {
+    padding: 0.1rem 0.45rem;
+    border: 1px solid $tilebg2;
+    border-radius: 0.25rem;
+    background-color: $tilebg4;
+    color: $greydesc;
+    font-size: 0.8rem;
+}
+
+.search-status {
+    margin: 0;
+    padding: 0.6rem 1.25rem;
+    color: $greydesc;
+    font-size: 0.9rem;
+
+    &:empty {
+        display: none;
+    }
+}
+
+.search-results {
+    margin: 0;
+    padding: 0 0 0.5rem;
+    overflow-y: auto;
+    list-style: none;
+
+    a {
+        display: block;
+        padding: 0.75rem 1.25rem;
+        color: inherit;
+        text-decoration: none;
+
+        &:hover,
+        &:focus-visible,
+        &[aria-selected="true"] {
+            background-color: $tilebg4;
+            outline: none;
+        }
+    }
+
+    .search-result-title {
+        color: $tiletext;
+        font-weight: 600;
+    }
+
+    .search-result-url {
+        color: $mudatagreen;
+        font-size: 0.8rem;
+    }
+
+    .search-result-excerpt {
+        display: block;
+        margin-top: 0.15rem;
+        color: $greydesc;
+        font-size: 0.9rem;
+        line-height: 1.35rem;
+
+        mark {
+            padding: 0;
+            background-color: rgba($scviyellow, 0.35);
+            color: inherit;
+        }
+    }
+}
diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html
index feff8d05..d4540935 100644
--- a/layouts/partials/footer.html
+++ b/layouts/partials/footer.html
@@ -1,4 +1,4 @@
-<footer>
+<footer data-pagefind-ignore>
   <div id="footer-content" class="container">
     <div class="row">
       <div class="col-12 col-md-6 col-lg-3">
diff --git a/layouts/partials/header.html b/layouts/partials/header.html
index 0356135f..0a016b75 100644
--- a/layouts/partials/header.html
+++ b/layouts/partials/header.html
@@ -1,4 +1,4 @@
-<div class="container" style="max-width: 1200px;">
+<div class="container" style="max-width: 1200px;" data-pagefind-ignore>
   <nav class="navbar navbar-expand-lg navbar-light">
     <div class="container-fluid" style="padding: 0;">
       <a class="navbar-brand row align-items-center m-0" href="/">
@@ -136,6 +136,13 @@
               >Conference</a
             >
           </li>
+          <li class="nav-item">
+            <button type="button" class="nav-link nav-search-button" id="search-open" aria-label="Search this site">
+              <i class="bi bi-search" aria-hidden="true"></i>
+              <span class="nav-search-label">Search</span>
+              <kbd class="nav-search-kbd" aria-hidden="true">/</kbd>
+            </button>
+          </li>
           <li class="nav-item">
             <a id="join-button" class="nav-link nav-button-hl" href="/join">Join</a>
           </li>
@@ -144,3 +151,25 @@
     </div>
   </nav>
 </div>
+
+<div class="search-overlay" id="search-overlay" hidden>
+  <div class="search-dialog" role="dialog" aria-modal="true" aria-labelledby="search-label" id="search-dialog">
+    <label class="visually-hidden" for="search-input" id="search-label">Search scverse.org</label>
+    <div class="search-field">
+      <i class="bi bi-search" aria-hidden="true"></i>
+      <input
+        type="search"
+        id="search-input"
+        class="search-input"
+        placeholder="Search packages, tutorials, events, blog posts…"
+        autocomplete="off"
+        spellcheck="false"
+        aria-describedby="search-status"
+        aria-controls="search-results"
+      />
+      <button type="button" class="search-close" id="search-close" aria-label="Close search">Esc</button>
+    </div>
+    <p class="search-status" id="search-status" role="status" aria-live="polite"></p>
+    <ul class="search-results" id="search-results"></ul>
+  </div>
+</div>
diff --git a/netlify.toml b/netlify.toml
index d16d0668..a013f448 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -1,4 +1,9 @@
 # Deploy previews used to build with Netlify's default Hugo (0.97.2, from 2022), so they did not reflect what gets published: .github/workflows/gh-pages.yml builds with `latest`, which currently resolves to 0.164.0.
 # Pin previews to that, and bump both together from here on.
+[build]
+# Netlify's Hugo preset stops at `hugo`; the search index is built after it.
+command = "hugo --buildFuture --minify && npx --yes pagefind@1.5.2 --site public"
+publish = "public"
+
 [build.environment]
 HUGO_VERSION = "0.164.0"
diff --git a/static/main.js b/static/main.js
index e2aee8d2..3c2447a9 100644
--- a/static/main.js
+++ b/static/main.js
@@ -381,6 +381,174 @@ const initInteractiveViz = () => {
   });
 }
 
+
+function initSearch() {
+  const openButton = document.getElementById('search-open')
+  const overlay = document.getElementById('search-overlay')
+  const dialog = document.getElementById('search-dialog')
+  const input = document.getElementById('search-input')
+  const status = document.getElementById('search-status')
+  const results = document.getElementById('search-results')
+  const closeButton = document.getElementById('search-close')
+  if (!openButton || !overlay) return
+
+  let pagefindPromise = null
+  let lastQuery = ''
+  let selected = -1
+  let debounce
+
+  // Memoises the promise, not the module: opening the dialog and typing both ask
+  // for the index, and calling Pagefind's init() twice over does not resolve.
+  function loadPagefind() {
+    if (!pagefindPromise) {
+      pagefindPromise = (async () => {
+        const engine = await import('/pagefind/pagefind.js')
+        await engine.options({ excerptLength: 25 })
+        await engine.init()
+        return engine
+      })().catch(() => {
+        // The index is written after `hugo` by `npx pagefind`, so a plain
+        // `hugo server` has nothing to load.
+        status.textContent = 'Search index unavailable. Run `npx pagefind --site public` after building.'
+        return null
+      })
+    }
+    return pagefindPromise
+  }
+
+  function open() {
+    overlay.hidden = false
+    document.body.style.overflow = 'hidden'
+    input.focus()
+    input.select()
+    loadPagefind()
+  }
+
+  function close() {
+    overlay.hidden = true
+    document.body.style.overflow = ''
+    openButton.focus()
+  }
+
+  function setSelected(next) {
+    const items = results.querySelectorAll('a')
+    if (!items.length) return
+    if (selected >= 0 && items[selected]) items[selected].removeAttribute('aria-selected')
+    selected = (next + items.length) % items.length
+    items[selected].setAttribute('aria-selected', 'true')
+    items[selected].scrollIntoView({ block: 'nearest' })
+  }
+
+  // Pagefind also matches when an indexed word is a prefix of the search term, so
+  // "xylophone" comes back matching "x" on seventeen pages. Keep a hit only if a
+  // word it actually matched starts with one of the terms that were typed.
+  function relevant(hit) {
+    const terms = lastQuery.toLowerCase().split(/\s+/).filter(term => term.length > 1)
+    if (!terms.length) return true
+    const matched = [...hit.excerpt.matchAll(/<mark>(.*?)<\/mark>/g)].map(m =>
+      m[1].toLowerCase().replace(/[^a-z0-9]/g, '')
+    )
+    return terms.some(term => matched.some(word => word.startsWith(term)))
+  }
+
+  async function render(query) {
+    if (query === lastQuery) return
+    lastQuery = query
+    selected = -1
+
+    if (query.length < 2) {
+      results.innerHTML = ''
+      status.textContent = ''
+      return
+    }
+
+    const engine = await loadPagefind()
+    if (!engine) return
+
+    status.textContent = 'Searching…'
+    const search = await engine.search(query)
+    if (query !== lastQuery) return
+
+    const candidates = await Promise.all(search.results.slice(0, 30).map(result => result.data()))
+    if (query !== lastQuery) return
+
+    const top = candidates.filter(relevant).slice(0, 12)
+
+    results.innerHTML = ''
+    if (!top.length) {
+      status.textContent = `No results for “${query}”`
+      return
+    }
+    status.textContent = `${top.length} result${top.length === 1 ? '' : 's'}`
+
+    top.forEach(hit => {
+      const item = document.createElement('li')
+      const link = document.createElement('a')
+      link.href = hit.url
+      link.innerHTML =
+        '<span class="search-result-title"></span> <span class="search-result-url"></span>' +
+        '<span class="search-result-excerpt"></span>'
+      link.querySelector('.search-result-title').textContent = hit.meta.title || hit.url
+      link.querySelector('.search-result-url').textContent = hit.url
+      // Pagefind returns the excerpt with <mark> around the matched terms.
+      link.querySelector('.search-result-excerpt').innerHTML = hit.excerpt
+      item.appendChild(link)
+      results.appendChild(item)
+    })
+  }
+
+  openButton.addEventListener('click', open)
+  closeButton.addEventListener('click', close)
+
+  overlay.addEventListener('mousedown', event => {
+    if (!dialog.contains(event.target)) close()
+  })
+
+  input.addEventListener('input', () => {
+    clearTimeout(debounce)
+    debounce = setTimeout(() => render(input.value.trim()), 150)
+  })
+
+  dialog.addEventListener('keydown', event => {
+    if (event.key === 'ArrowDown') {
+      event.preventDefault()
+      setSelected(selected + 1)
+    } else if (event.key === 'ArrowUp') {
+      event.preventDefault()
+      setSelected(selected - 1)
+    } else if (event.key === 'Enter') {
+      const items = results.querySelectorAll('a')
+      if (selected >= 0 && items[selected]) {
+        event.preventDefault()
+        items[selected].click()
+      }
+    } else if (event.key === 'Tab') {
+      // Keep focus inside the dialog while it is open.
+      const focusable = dialog.querySelectorAll('input, button, a')
+      const first = focusable[0]
+      const last = focusable[focusable.length - 1]
+      if (event.shiftKey && document.activeElement === first) {
+        event.preventDefault()
+        last.focus()
+      } else if (!event.shiftKey && document.activeElement === last) {
+        event.preventDefault()
+        first.focus()
+      }
+    }
+  })
+
+  document.addEventListener('keydown', event => {
+    if (event.key === 'Escape' && !overlay.hidden) {
+      close()
+    } else if (overlay.hidden && (event.key === '/' || ((event.metaKey || event.ctrlKey) && event.key === 'k'))) {
+      const tag = document.activeElement && document.activeElement.tagName
+      if (tag === 'INPUT' || tag === 'TEXTAREA') return
+      event.preventDefault()
+      open()
+    }
+  })
+}
+
 // Initialize everything when DOM is loaded
 document.addEventListener('DOMContentLoaded', function() {
   initEcosystemRegistry()
@@ -392,6 +560,8 @@ document.addEventListener('DOMContentLoaded', function() {
 
   initTableOfContents()
 
+  initSearch()
+
   // Initialize interactive visualization if on home page
   initInteractiveViz()
 })

From 01beb4aeca4c2a6fce3dbab531a0abf2a73f4acb Mon Sep 17 00:00:00 2001
From: Lukas Heumos <lukas.heumos@posteo.net>
Date: Sun, 23 Aug 2026 23:14:30 +0200
Subject: [PATCH 2/3] Fix the gap the next-event section opened on the front
 page

#packages carried margin-top: 15% where every other section has 5%, which read as
deliberate while it sat directly under the hero demo. Adding a section above it
moved that gap into the middle of the page.

The wide gap now belongs to the demo, so it stays under the hero wherever the next
section happens to be. It has to be set in the nested block: the flat
#interactive-demo-section rule is outranked by section { margin: 0 auto }, which is
why its margin-bottom never did anything.

Signed-off-by: Lukas Heumos <lukas.heumos@posteo.net>
---
 assets/main.scss | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/assets/main.scss b/assets/main.scss
index 3d7ec806..b5400b60 100644
--- a/assets/main.scss
+++ b/assets/main.scss
@@ -514,8 +514,12 @@ body {
                         }
                     }
                 }
+                // The wide gap under the hero used to live on #packages, which put it
+                // between whatever section came after the demo and the packages.
+                #interactive-demo-section {
+                    margin-bottom: 15%;
+                }
                 #packages {
-                    margin-top: 15%;
                     #packages-list {
                         .card {
                             display: flex;
@@ -2547,7 +2551,6 @@ $eco-hues:
 // Interactive UMAP Visualization Styles
 #interactive-demo-section {
     margin-top: 8%;
-    margin-bottom: 5%;
 }
 
 .interactive-container {

From 0dd9c853d1f42a4dfea1f3b3c9e9d050ce4a50cf Mon Sep 17 00:00:00 2001
From: Lukas Heumos <lukas.heumos@posteo.net>
Date: Sun, 23 Aug 2026 23:14:30 +0200
Subject: [PATCH 3/3] Put packages and people at the top of search results

Searching for pertpy returned a blog post that mentions it; the package itself was
not in the results at all, because scverse.org has no page per package or per person
and Pagefind only knows about pages.

layouts/index.entities.json collects the 12 core packages, the 120 registry entries
and everyone on the people page into a name index. A name match is pinned above the
page results and links to the thing itself: the package's documentation, or the
person's GitHub profile.

Also fixes the relevance filter, which stripped punctuation from the word Pagefind
matched but not from the word that was typed, so "rapids-singlecell" found
"rapids-singlecell" and then discarded it.

Signed-off-by: Lukas Heumos <lukas.heumos@posteo.net>
---
 .prettierrc.cjs             |  2 +-
 README.md                   |  5 +--
 assets/main.scss            | 15 +++++++
 config.toml                 |  9 +++++
 layouts/index.entities.json | 65 +++++++++++++++++++++++++++++
 static/main.js              | 81 ++++++++++++++++++++++++++++++-------
 6 files changed, 159 insertions(+), 18 deletions(-)
 create mode 100644 layouts/index.entities.json

diff --git a/.prettierrc.cjs b/.prettierrc.cjs
index 1085a96a..1c2ef06a 100644
--- a/.prettierrc.cjs
+++ b/.prettierrc.cjs
@@ -7,7 +7,7 @@ module.exports = {
     plugins: [require.resolve("prettier-plugin-go-template")],
     overrides: [
         {
-            files: ["*.html"],
+            files: ["*.html", "layouts/**/*.json"],
             options: {
                 parser: "go-template",
             },
diff --git a/README.md b/README.md
index c13794c2..dd647486 100644
--- a/README.md
+++ b/README.md
@@ -27,9 +27,8 @@ To build the website (with hot reload), [install Hugo](https://gohugo.io/getting
 hugo server -D
 ```
 
-Site search is powered by [Pagefind](https://pagefind.app/), which indexes the built HTML
-rather than the content files, so `hugo server` alone has no index and the search dialog
-will say so. To try it locally, build and index the site, then serve `public/`:
+Site search is powered by [Pagefind](https://pagefind.app/), which indexes the built HTML rather than the content files, so `hugo server` alone has no index and the search dialog will say so.
+To try it locally, build and index the site, then serve `public/`:
 
 ```sh
 hugo && npx pagefind --site public && python3 -m http.server -d public
diff --git a/assets/main.scss b/assets/main.scss
index b5400b60..4faf62d0 100644
--- a/assets/main.scss
+++ b/assets/main.scss
@@ -2916,6 +2916,21 @@ $eco-hues:
         font-size: 0.8rem;
     }
 
+    .search-result-kind {
+        padding: 0.05rem 0.4rem;
+        border-radius: 0.25rem;
+        background-color: rgba($scviyellow, 0.25);
+        color: $tiletext2;
+        font-size: 0.75rem;
+        white-space: nowrap;
+    }
+
+    .search-result-entity .search-result-title::after {
+        content: " ↗";
+        color: $greydesc;
+        font-weight: 400;
+    }
+
     .search-result-excerpt {
         display: block;
         margin-top: 0.15rem;
diff --git a/config.toml b/config.toml
index 434cfdc0..b1912d03 100644
--- a/config.toml
+++ b/config.toml
@@ -12,6 +12,15 @@ enableRobotsTXT = true
 images = ["img/scverse-social-card.png"]
 description = "Foundational tools for omics data in the life sciences"
 
+[outputs]
+home = ["html", "rss", "entities"]
+
+[outputFormats.entities]
+mediaType = "application/json"
+baseName = "search-entities"
+isPlainText = true
+notAlternative = true
+
 [markup.goldmark.renderer]
 unsafe= true
 
diff --git a/layouts/index.entities.json b/layouts/index.entities.json
new file mode 100644
index 00000000..6c4d813c
--- /dev/null
+++ b/layouts/index.entities.json
@@ -0,0 +1,65 @@
+{{- $entities := slice -}}
+
+{{- with site.GetPage "/packages" -}}
+    {{- range (append (.Params.packages | default slice) (.Params.datastructures | default slice)) -}}
+        {{- $docs := .url -}}
+        {{- range .links -}}
+            {{- if hasPrefix (lower .text) "documentation" -}}
+                {{- $docs = .url -}}
+            {{- end -}}
+        {{- end -}}
+        {{- $entities = $entities | append (dict
+            "kind" "Core package"
+            "name" .name
+            "detail" .description
+            "url" $docs
+            "site" "/packages/#core-packages")
+        -}}
+    {{- end -}}
+{{- end -}}
+
+{{- $registry := resources.GetRemote "https://scverse.org/ecosystem-packages/packages.json" -}}
+{{- with $registry -}}
+    {{- range (transform.Unmarshal .Content) -}}
+        {{- $desc := trim (.description | markdownify | plainify | htmlUnescape | replaceRE `\s+` " ") " " -}}
+        {{- $entities = $entities | append (dict
+            "kind" "Ecosystem package"
+            "name" .name
+            "detail" $desc
+            "url" (or .documentation_home .project_home)
+            "site" "/packages/#ecosystem")
+        -}}
+    {{- end -}}
+{{- end -}}
+
+{{- with site.GetPage "/people" -}}
+    {{- range .Params.teams -}}
+        {{- $team := .name -}}
+        {{- range .members -}}
+            {{- $detail := $team -}}
+            {{- with .role -}}{{- $detail = printf "%s · %s" $team . -}}{{- end -}}
+            {{- with .affiliation -}}
+                {{- $detail = printf "%s · %s" $detail . -}}
+            {{- end -}}
+            {{- $entities = $entities | append (dict
+                "kind" $team
+                "name" .name
+                "detail" $detail
+                "url" .url
+                "site" "/people/")
+            -}}
+        {{- end -}}
+    {{- end -}}
+{{- end -}}
+
+{{- /* The registry repeats the core packages and people sit on several teams. */ -}}
+{{- $seen := slice -}}
+{{- $unique := slice -}}
+{{- range $entities -}}
+    {{- $key := lower .name -}}
+    {{- if not (in $seen $key) -}}
+        {{- $seen = $seen | append $key -}}
+        {{- $unique = $unique | append . -}}
+    {{- end -}}
+{{- end -}}
+{{- $unique | jsonify -}}
diff --git a/static/main.js b/static/main.js
index 3c2447a9..d0ff8d2a 100644
--- a/static/main.js
+++ b/static/main.js
@@ -397,8 +397,37 @@ function initSearch() {
   let selected = -1
   let debounce
 
-  // Memoises the promise, not the module: opening the dialog and typing both ask
-  // for the index, and calling Pagefind's init() twice over does not resolve.
+  let entitiesPromise = null
+
+  function loadEntities() {
+    if (!entitiesPromise) {
+      entitiesPromise = fetch('/search-entities.json')
+        .then(response => response.json())
+        .catch(() => [])
+    }
+    return entitiesPromise
+  }
+
+  function matchEntities(entities, query) {
+    const terms = normalise(query)
+    if (!terms.length) return []
+    return entities
+      .map(entity => {
+        const name = entity.name.toLowerCase()
+        const words = normalise(entity.name)
+        let rank = -1
+        if (name === query.toLowerCase()) rank = 0
+        else if (name.startsWith(query.toLowerCase())) rank = 1
+        else if (terms.every(term => words.some(word => word.startsWith(term)))) rank = 2
+        return { entity, rank }
+      })
+      .filter(scored => scored.rank >= 0)
+      .sort((a, b) => a.rank - b.rank || a.entity.name.length - b.entity.name.length)
+      .slice(0, 3)
+      .map(scored => scored.entity)
+  }
+
+  // Memoises the promise, not the module: two concurrent init() calls never resolve.
   function loadPagefind() {
     if (!pagefindPromise) {
       pagefindPromise = (async () => {
@@ -407,8 +436,7 @@ function initSearch() {
         await engine.init()
         return engine
       })().catch(() => {
-        // The index is written after `hugo` by `npx pagefind`, so a plain
-        // `hugo server` has nothing to load.
+        // The index is written after `hugo` by `npx pagefind`.
         status.textContent = 'Search index unavailable. Run `npx pagefind --site public` after building.'
         return null
       })
@@ -439,18 +467,23 @@ function initSearch() {
     items[selected].scrollIntoView({ block: 'nearest' })
   }
 
-  // Pagefind also matches when an indexed word is a prefix of the search term, so
-  // "xylophone" comes back matching "x" on seventeen pages. Keep a hit only if a
-  // word it actually matched starts with one of the terms that were typed.
+  // Pagefind matches when an indexed word is a prefix of the search term, so
+  // "xylophone" comes back matching "x" on seventeen pages.
   function relevant(hit) {
-    const terms = lastQuery.toLowerCase().split(/\s+/).filter(term => term.length > 1)
+    const terms = normalise(lastQuery)
     if (!terms.length) return true
-    const matched = [...hit.excerpt.matchAll(/<mark>(.*?)<\/mark>/g)].map(m =>
-      m[1].toLowerCase().replace(/[^a-z0-9]/g, '')
-    )
+    const matched = [...hit.excerpt.matchAll(/<mark>(.*?)<\/mark>/g)].flatMap(m => normalise(m[1]))
     return terms.some(term => matched.some(word => word.startsWith(term)))
   }
 
+  // Both sides must be split the same way, or "rapids-singlecell" fails to match itself.
+  function normalise(text) {
+    return text
+      .toLowerCase()
+      .split(/[^a-z0-9]+/)
+      .filter(word => word.length > 1)
+  }
+
   async function render(query) {
     if (query === lastQuery) return
     lastQuery = query
@@ -462,6 +495,9 @@ function initSearch() {
       return
     }
 
+    const pinned = matchEntities(await loadEntities(), query)
+    if (query !== lastQuery) return
+
     const engine = await loadPagefind()
     if (!engine) return
 
@@ -475,11 +511,29 @@ function initSearch() {
     const top = candidates.filter(relevant).slice(0, 12)
 
     results.innerHTML = ''
-    if (!top.length) {
+    if (!top.length && !pinned.length) {
       status.textContent = `No results for “${query}”`
       return
     }
-    status.textContent = `${top.length} result${top.length === 1 ? '' : 's'}`
+    const total = top.length + pinned.length
+    status.textContent = `${total} result${total === 1 ? '' : 's'}`
+
+    pinned.forEach(entity => {
+      const item = document.createElement('li')
+      const link = document.createElement('a')
+      link.href = entity.url
+      link.target = '_blank'
+      link.rel = 'noopener'
+      link.className = 'search-result-entity'
+      link.innerHTML =
+        '<span class="search-result-title"></span> <span class="search-result-kind"></span>' +
+        '<span class="search-result-excerpt"></span>'
+      link.querySelector('.search-result-title').textContent = entity.name
+      link.querySelector('.search-result-kind').textContent = entity.kind
+      link.querySelector('.search-result-excerpt').textContent = entity.detail
+      item.appendChild(link)
+      results.appendChild(item)
+    })
 
     top.forEach(hit => {
       const item = document.createElement('li')
@@ -490,7 +544,6 @@ function initSearch() {
         '<span class="search-result-excerpt"></span>'
       link.querySelector('.search-result-title').textContent = hit.meta.title || hit.url
       link.querySelector('.search-result-url').textContent = hit.url
-      // Pagefind returns the excerpt with <mark> around the matched terms.
       link.querySelector('.search-result-excerpt').innerHTML = hit.excerpt
       item.appendChild(link)
       results.appendChild(item)