Search Indexing

Lane-A Shard

The Lane-A shard is a prerendered JSON array of SearchRecord objects — titles only, no body text. It is built at deploy time by buildSearchIndex(locale) in $lib/server/search/query.ts and served as a static CDN asset.

Route: GET /api/search-index/[locale] Handler: src/routes/api/search-index/[locale]/+server.ts Prerender: export const prerender = true Entries: en, de, ru

Unknown locales (e.g., /api/search-index/fr) return [] with HTTP 404.

The shard is lazy-fetched on the first palette open and held in memory for the session. Locale switches trigger a fresh fetch.

Server Adapters

All adapters live in $lib/server/search/adapters/ and produce SearchRecord[].

pages.ts

Source: the nav registry ($lib/nav). Paraglide labels — genuinely localized, no fallback badge.

Also injects two public pages absent from the nav registry: /auth/login (Log in) and /showcases/jobs (Jobs). The index covers these public routes even though nav omits them.

Filters out /account/* and /admin/* paths: anonymous search never reveals protected route existence. Also excludes hub-only redirect paths listed in _redirects.ts.

showcases.ts

Source: showcase card tree ($lib/showcases/registry) + curated in-page sections ($lib/showcases/sections).

Card and sublink titles are Paraglide message functions resolved per index shard — genuinely localized, localeFallback: false. Only the curated in-page section titles remain English-only: localeFallback: true for de/ru, rendered with an "EN" badge and a small rank penalty.

Sections produce surface: 'section' records with anchor: '#anchorId' for deep linking. Keywords come from curated section.keywords arrays.

docs.ts

Source: build-time markdown manifest ($lib/server/docs/manifest).

Two output modes:

• Lane A (docTitleRecords): title + description, no body. localeFallback: true for non-EN locales.
• Lane B (searchDocs): full-body lexical scan with scoreRecords() + extractSnippet(). The corpus is built once per server instance (module-level cache). No DB round-trip — docs are already eager-globbed into the server bundle at deploy time.

Markdown is stripped to plain text before indexing: fenced code blocks, inline code, links, HTML tags, heading/list markers, emphasis characters, table pipes.

_redirects.ts

A Set<string> of hub-only hrefs that only redirect to a child page. Excluded from the index so search never lands a user on a bounce page.

Locale Model

Docs and curated in-page sections are English-only today. Non-EN users see these results with:

• localeFallback: true on the SearchRecord
• badge: 'en-fallback' on the SearchResult
• An "EN" badge rendered next to the title in the palette and /search page
• A 15% rank penalty (score *= 0.85) so native-locale results rank above EN fallbacks

Paths in the shard are locale-bare (e.g., /docs/stack/svelte). localizeHref() is called at render time, not at index time. This means the shard works for all locales without duplication.

The architecture is locale-parameterized: when native de/ru markdown is authored later, only the adapter needs a locale dimension. The search engine, shard endpoint, and client code are unchanged.

Page (pages.ts) and showcase (showcases.ts) records are not locale-fallbacks — nav labels and showcase card/sublink titles are both genuinely localized via Paraglide, so the German user sees German page and card names. Only section (sections.ts) and doc records fall back to English.

buildSearchIndex(locale)

function buildSearchIndex(locale: SearchLocale): SearchRecord[] {
  // Pins Paraglide locale so nav labels render in the right language.
  return [...pageRecords(locale), ...showcaseRecords(locale), ...docTitleRecords(locale)];
}

Called by the +server.ts shard handler at prerender time. Also called directly by the /search SSR load function (no self-fetch needed server-side).