reallysimpledocs 1.0.0-beta.2 → 1.0.0-beta.4

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [1.0.0-beta.4] - 2026-06-16
+
+### Added
+
+- Added MDX documentation components for callouts, code blocks, code groups, previews, tabs, steps, and cards.
+- Added automatic MDX component availability in docs pages, so common ReallySimpleDocs components do not need page-level imports.
+- Added custom `mdxComponents` registration for project-specific MDX components.
+- Added custom `markdownSerializers` registration so project-specific MDX components can control Markdown, search, and LLM export output.
+- Added Markdown export serializers for ReallySimpleDocs components so generated Markdown, search content, and `llms-full.txt` avoid raw MDX component noise.
+- Added customizable sidebar header, sidebar footer, and content header component overrides.
+- Added breadcrumb rendering from the docs navigation tree.
+- Added Lunr-powered command search with result previews and highlighted matches.
+- Added Basecoat style selection through the ReallySimpleDocs integration config.
+
+### Changed
+
+- Ported ReallySimpleDocs to an Astro integration with generated docs routes, assets, Markdown exports, search index, and Basecoat styling.
+- Updated docs content to use Markdown by default and MDX only for richer component examples.
+- Updated code examples to use inline component children instead of passing source code as props.
+- Changed empty table-of-contents behavior so the right panel is hidden instead of rendering an empty “On this page” section.
+- Changed breadcrumbs to render in the sticky content header for nested pages.
+- Updated the docs overview and component pages to explain component usage, Markdown output, and Basecoat interoperability.
+
+### Fixed
+
+- Fixed Shiki code block colors across light and dark mode.
+- Fixed copy-code button layout for regular code blocks and tabbed code blocks.
+- Fixed callout rendering in Markdown and MDX pages.
+- Fixed sidebar and header markup to follow Basecoat component patterns.

package/README.md

@@ -2,7 +2,9 @@
 
 A simple documentation system for Astro, built with **Basecoat** and **Tailwind CSS**.
 
-RSD keeps docs portable: content lives in `docs/`, navigation lives in `docs/docs.json`, and the Astro integration owns the docs UI.
+ReallySimpleDocs gives you a shadcn/ui-compatible docs template without a React runtime. It uses Basecoat for the same design language and CSS-variable model, while staying close to plain Astro, Markdown, HTML, CSS, and a small amount of vanilla JavaScript.
+
+Docs stay portable: content lives in `docs/`, navigation lives in `docs/docs.json`, and the Astro integration owns the docs UI.
 
 ## Add to an Astro site
 
@@ -59,21 +61,19 @@ docs/
 Welcome to the docs.
 ```
 
-RSD injects docs pages, Lunr search, per-page Markdown exports, `llms.txt`, and `llms-full.txt`.
+ReallySimpleDocs injects docs pages, Lunr search, per-page Markdown exports, `llms.txt`, and `llms-full.txt`.
 
-Use `.md` for normal pages and `.mdx` when a page needs Astro components:
+Use `.mdx` when a page needs ReallySimpleDocs components. Common ReallySimpleDocs components are available by default, so you do not need to import them in each page:
 
 ```mdx
-import { Callout, Preview } from "reallysimpledocs/components";
-
 # Button
 
-<Callout type="tip">MDX is optional. Plain Markdown stays the default.</Callout>
+<Callout title="MDX works">MDX is optional. Plain Markdown stays the default.</Callout>
 ```
 
 ## Use Basecoat on the rest of the site
 
-RSD styles and scripts its generated docs pages. For custom Astro pages outside the docs route, use Basecoat directly in your own layout.
+ReallySimpleDocs styles and scripts its generated docs pages. For custom Astro pages outside the docs route, such as a landing page or app page, use Basecoat directly in your own layout.
 
 Install stays the same:
 
@@ -103,7 +103,7 @@ import "basecoat-css/all.min";
 <slot />
 ```
 
-Use the same Basecoat `style` in your RSD config and your site stylesheet if you want the docs and custom pages to match.
+Use the same Basecoat `style` in your ReallySimpleDocs config and your site stylesheet if you want the docs and custom pages to match.
 
 ## Local development (this repo)
 
@@ -116,13 +116,13 @@ npm run dev
 
 Go to [ReallySimpleDocs.com](https://reallysimpledocs.com).
 
-## Support the project 
+## Support the project
 
-- [Contribute code](/CONTRIBUTING.md)
+- [Contribute code](https://github.com/hunvreus/reallysimpledocs/blob/main/CONTRIBUTING.md)
 - [Report issues](https://github.com/hunvreus/reallysimpledocs/issues)
 - [Sponsor me](https://github.com/sponsors/hunvreus)
 - [Star the project on GitHub](https://github.com/hunvreus/reallysimpledocs)
 
 ## License
 
-[MIT](/LICENSE.md)
+[MIT](https://github.com/hunvreus/reallysimpledocs/blob/main/LICENSE.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reallysimpledocs",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.4",
   "type": "module",
   "exports": {
     ".": "./src/index.js",
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE.md"
   ],
   "scripts": {
@@ -20,6 +21,7 @@
     "check": "npm run build && npm pack --dry-run && npm run smoke:consumer"
   },
   "dependencies": {
+    "@astrojs/markdown-remark": "^7.2.0",
     "@astrojs/mdx": "^6.0.3",
     "@tailwindcss/vite": "4.1.17",
     "astro": "^6.4.6",
@@ -27,7 +29,13 @@
     "lucide-static": "^0.552.0",
     "lunr": "^2.3.9",
     "marked": "^16.4.1",
-    "shiki": "^4.1.0"
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx": "^3.1.1",
+    "remark-parse": "^11.0.0",
+    "shiki": "^4.1.0",
+    "unified": "^11.0.5"
   },
   "peerDependencies": {
     "basecoat-css": "^1.0.0-beta.2",

package/src/astro/index.js

@@ -1,8 +1,10 @@
 import { fileURLToPath } from "node:url";
 import fs from "node:fs";
 import path from "node:path";
+import { unified as astroMarkdown } from "@astrojs/markdown-remark";
 import mdx from "@astrojs/mdx";
 import tailwindcss from "@tailwindcss/vite";
+import { previewSourceRemarkPlugin } from "../runtime/lib/preview-source-plugin.js";
 
 const basecoatStyles = new Set(["vega", "nova", "maia", "lyra", "mira", "luma", "sera", "rhea"]);
 
@@ -26,6 +28,21 @@ const normalizeArray = (value) => (Array.isArray(value) ? value : value ? [value
 
 const normalizeImportPath = (filePath) => filePath.replaceAll(path.sep, "/");
 
+const normalizeRecord = (value) => (value && typeof value === "object" && !Array.isArray(value) ? value : {});
+
+const isInsideDir = (dir, file) => {
+  const relative = path.relative(dir, file);
+  return relative && !relative.startsWith("..") && !path.isAbsolute(relative);
+};
+
+const shikiConfig = {
+  themes: {
+    light: "github-light",
+    dark: "github-dark",
+  },
+  defaultColor: false,
+};
+
 function collectMdxModules(docsDir) {
   if (!fs.existsSync(docsDir)) return {};
   const modules = {};
@@ -46,6 +63,18 @@ function collectMdxModules(docsDir) {
   return modules;
 }
 
+function componentModuleSource(modules) {
+  const entries = Object.entries(modules);
+  const imports = entries
+    .map(([name, moduleId], index) => `import component${index} from ${JSON.stringify(moduleId)};`)
+    .join("\n");
+  return `${imports}
+export default {
+${entries.map(([name], index) => `  ${JSON.stringify(name)}: component${index},`).join("\n")}
+};
+`;
+}
+
 export default function reallySimpleDocs(options = {}) {
   const style = options.style || "vega";
   if (!basecoatStyles.has(style)) {
@@ -59,6 +88,8 @@ export default function reallySimpleDocs(options = {}) {
     style,
     customCss: normalizeArray(options.customCss),
     components: options.components || {},
+    mdxComponents: normalizeRecord(options.mdxComponents),
+    markdownSerializers: normalizeRecord(options.markdownSerializers),
     routeBase: options.routeBase ?? "/docs",
     assetsBase: options.assetsBase || "/assets",
   };
@@ -71,18 +102,35 @@ export default function reallySimpleDocs(options = {}) {
         const generatedDir = path.join(root, ".astro", "reallysimpledocs");
         const generatedStyles = path.join(generatedDir, "styles.css");
         const docsDir = path.resolve(root, normalizedOptions.docsDir);
+        const resolveUserId = (id) => (id?.startsWith(".") ? path.resolve(root, id) : id);
+        const markdownSerializers = Object.fromEntries(
+          Object.entries(normalizedOptions.markdownSerializers).map(([name, moduleId]) => [
+            name,
+            normalizeImportPath(resolveUserId(moduleId)),
+          ]),
+        );
+        const mdxComponents = Object.fromEntries(
+          Object.entries(normalizedOptions.mdxComponents).map(([name, moduleId]) => [
+            name,
+            normalizeImportPath(resolveUserId(moduleId)),
+          ]),
+        );
         const virtualConfig = {
           ...normalizedOptions,
           root,
           docsDir,
           siteFile: normalizedOptions.siteFile ? path.resolve(root, normalizedOptions.siteFile) : null,
+          mdxComponents,
+          markdownSerializers,
           routeBase: normalizeRouteBase(normalizedOptions.routeBase),
         };
-        const mdxModules = collectMdxModules(docsDir);
-        const resolveUserId = (id) => (id?.startsWith(".") ? path.resolve(root, id) : id);
         const components = {
+          ContentHeader:
+            normalizedOptions.components.ContentHeader || runtimePath("components/DefaultContentHeader.astro"),
           SidebarHeader:
             normalizedOptions.components.SidebarHeader || runtimePath("components/DefaultSidebarHeader.astro"),
+          SidebarFooter:
+            normalizedOptions.components.SidebarFooter || runtimePath("components/DefaultSidebarFooter.astro"),
         };
         fs.mkdirSync(generatedDir, { recursive: true });
         fs.writeFileSync(
@@ -123,7 +171,18 @@ export default function reallySimpleDocs(options = {}) {
         });
 
         updateConfig({
-          integrations: [mdx()],
+          integrations: [
+            mdx({
+              syntaxHighlight: "shiki",
+              shikiConfig,
+            }),
+          ],
+          markdown: {
+            processor: astroMarkdown({
+              remarkPlugins: [previewSourceRemarkPlugin],
+            }),
+            shikiConfig,
+          },
           vite: {
             build: {
               cssMinify: false,
@@ -132,18 +191,41 @@ export default function reallySimpleDocs(options = {}) {
               tailwindcss(),
               {
                 name: "reallysimpledocs-virtual-modules",
+                configureServer(server) {
+                  const invalidateMdxPages = () => {
+                    const module = server.moduleGraph.getModuleById("\0virtual:reallysimpledocs/mdx-pages");
+                    if (module) server.moduleGraph.invalidateModule(module);
+                    server.ws.send({ type: "full-reload" });
+                  };
+
+                  server.watcher.add(path.join(docsDir, "**/*.mdx"));
+                  server.watcher.on("add", (file) => {
+                    if (file.endsWith(".mdx") && isInsideDir(docsDir, file)) invalidateMdxPages();
+                  });
+                  server.watcher.on("unlink", (file) => {
+                    if (file.endsWith(".mdx") && isInsideDir(docsDir, file)) invalidateMdxPages();
+                  });
+                },
                 resolveId(id) {
                   if (id === "virtual:reallysimpledocs/config") return "\0virtual:reallysimpledocs/config";
                   if (id === "virtual:reallysimpledocs/mdx-pages") return "\0virtual:reallysimpledocs/mdx-pages";
+                  if (id === "virtual:reallysimpledocs/mdx-components") return "\0virtual:reallysimpledocs/mdx-components";
                   if (id === "virtual:reallysimpledocs/styles.css") return generatedStyles;
                   if (id === "virtual:reallysimpledocs/components/SidebarHeader") {
                     return "\0virtual:reallysimpledocs/components/SidebarHeader";
                   }
+                  if (id === "virtual:reallysimpledocs/components/SidebarFooter") {
+                    return "\0virtual:reallysimpledocs/components/SidebarFooter";
+                  }
+                  if (id === "virtual:reallysimpledocs/components/ContentHeader") {
+                    return "\0virtual:reallysimpledocs/components/ContentHeader";
+                  }
                   return null;
                 },
                 load(id) {
                   if (id === "\0virtual:reallysimpledocs/config") return `export default ${JSON.stringify(virtualConfig)};`;
                   if (id === "\0virtual:reallysimpledocs/mdx-pages") {
+                    const mdxModules = collectMdxModules(docsDir);
                     const imports = Object.entries(mdxModules)
                       .map(([slug, filePath], index) => `import * as mdx${index} from ${JSON.stringify(filePath)};`)
                       .join("\n");
@@ -159,9 +241,18 @@ export async function getMdxPage(slug) {
 }
 `;
                   }
+                  if (id === "\0virtual:reallysimpledocs/mdx-components") {
+                    return componentModuleSource(mdxComponents);
+                  }
                   if (id === "\0virtual:reallysimpledocs/components/SidebarHeader") {
                     return `export { default } from ${JSON.stringify(resolveUserId(components.SidebarHeader))};`;
                   }
+                  if (id === "\0virtual:reallysimpledocs/components/SidebarFooter") {
+                    return `export { default } from ${JSON.stringify(resolveUserId(components.SidebarFooter))};`;
+                  }
+                  if (id === "\0virtual:reallysimpledocs/components/ContentHeader") {
+                    return `export { default } from ${JSON.stringify(resolveUserId(components.ContentHeader))};`;
+                  }
                   return null;
                 },
               },

package/src/components/index.js

@@ -2,13 +2,11 @@ export { default as DocsLayout } from "../runtime/components/DocsLayout.astro";
 export { default as CommandDialog } from "../runtime/components/CommandDialog.astro";
 export { default as DropdownMenu } from "../runtime/components/DropdownMenu.astro";
 export { default as Sidebar } from "../runtime/components/Sidebar.astro";
-export { default as Badge } from "../runtime/components/mdx/Badge.astro";
 export { default as Callout } from "../runtime/components/mdx/Callout.astro";
 export { default as Card } from "../runtime/components/mdx/Card.astro";
 export { default as CardGrid } from "../runtime/components/mdx/CardGrid.astro";
 export { default as Code } from "../runtime/components/mdx/Code.astro";
 export { default as CodeGroup } from "../runtime/components/mdx/CodeGroup.astro";
-export { default as LinkButton } from "../runtime/components/mdx/LinkButton.astro";
 export { default as Preview } from "../runtime/components/mdx/Preview.astro";
 export { default as Step } from "../runtime/components/mdx/Step.astro";
 export { default as Steps } from "../runtime/components/mdx/Steps.astro";

package/src/css/custom.css

@@ -23,37 +23,40 @@
   > h1:first-child {
     @apply hidden;
   }
-  p > a,
-  li > a,
-  dt > a,
-  dd > a,
-  td > a,
-  th > a {
+  > p > a,
+  > blockquote a,
+  > :is(ol, ul) a,
+  > dl a,
+  > table a {
     @apply underline underline-offset-2 decoration-muted-foreground/50 hover:decoration-foreground/50 transition-all;
   }
-  code:not(pre > code) {
+  > p code:not(pre > code),
+  > blockquote code:not(pre > code),
+  > :is(ol, ul) code:not(pre > code),
+  > dl code:not(pre > code),
+  > table code:not(pre > code) {
     @apply relative rounded-md bg-muted px-[0.3rem] py-[0.2rem] font-mono text-[13px];
   }
-  pre {
+  > pre {
     @apply rounded-lg;
   }
-  pre > code {
+  > pre > code {
     @apply block min-w-full w-max px-4 py-3 text-[13px];
   }
-  pre:has(> code) {
+  > pre:has(> code) {
     @apply max-w-full overflow-x-auto;
   }
-  blockquote {
+  > blockquote {
     @apply border-l-4 border-border pl-4;
   }
-  ol {
+  > ol {
     @apply list-decimal ml-6;
   }
-  ul {
+  > ul {
     @apply list-disc ml-6;
   }
-  ol,
-  ul {
+  > ol,
+  > ul {
     li {
       @apply mt-2;
 
@@ -63,7 +66,7 @@
       }
     }
   }
-  dl {
+  > dl {
     @apply border-b pb-3 my-6;
     dt {
       @apply border-t pt-3 mt-3 first:mt-0;
@@ -75,16 +78,24 @@
       @apply mt-4 border-b-0 pb-0 pl-8 my-0;
     }
   }
-  b,
-  strong {
+  > p b,
+  > p strong,
+  > blockquote b,
+  > blockquote strong,
+  > :is(ol, ul) b,
+  > :is(ol, ul) strong,
+  > dl b,
+  > dl strong,
+  > table b,
+  > table strong {
     @apply font-semibold;
   }
   > p,
-  blockquote,
-  ul,
-  ol,
-  dl,
-  pre {
+  > blockquote,
+  > ul,
+  > ol,
+  > dl,
+  > pre {
     @apply my-6;
   }
   > *:first-child {
@@ -93,7 +104,7 @@
   > *:last-child {
     @apply !mb-0;
   }
-  table {
+  > table {
     @apply w-full caption-bottom text-sm;
     thead {
       @apply [&_tr]:border-b;
@@ -119,20 +130,25 @@
   }
 }
 
-.shiki {
-  @apply bg-muted dark:bg-muted/50;
+.shiki,
+.astro-code {
+  @apply bg-muted/50;
+  background-color: color-mix(in oklab, var(--color-muted) 50%, transparent) !important;
   color: var(--shiki-light);
 }
 
-.shiki span {
+.shiki span,
+.astro-code span {
   color: var(--shiki-light);
 }
 
-html.dark .shiki {
+html.dark .shiki,
+html.dark .astro-code {
   color: var(--shiki-dark);
 }
 
-html.dark .shiki span {
+html.dark .shiki span,
+html.dark .astro-code span {
   color: var(--shiki-dark);
 }
 
@@ -155,179 +171,3 @@ html.dark .shiki span {
 .command mark {
   @apply bg-search-highlight/50 text-foreground rounded-sm px-0.5 dark:bg-search-highlight/25;
 }
-
-.docs-card-link {
-  @apply transition-colors hover:bg-muted/50 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50;
-}
-
-.alert[data-variant='warning'] > svg,
-.alert[data-variant='warning'] > h3,
-.alert[data-variant='warning'] > section {
-  @apply text-amber-700 dark:text-amber-300;
-}
-
-.alert-destructive[data-variant='danger'] > svg,
-.alert-destructive[data-variant='danger'] > h3,
-.alert-destructive[data-variant='danger'] > section {
-  @apply text-destructive;
-}
-
-.code-block {
-  @apply relative my-6 max-w-full overflow-hidden rounded-lg;
-}
-
-.code-block > header,
-.code-group > header,
-.preview > header {
-  @apply flex h-10 items-center gap-2 border-b border-border/50 bg-muted px-3 text-sm font-medium dark:bg-muted/50;
-}
-
-.code-block > header > :first-child,
-.code-group > header > :first-child,
-.preview > header > :first-child {
-  @apply mr-auto;
-}
-
-.code-block > pre {
-  @apply my-0 max-w-full overflow-x-auto rounded-none border-0;
-}
-
-.code-block > pre > code {
-  @apply block min-w-full w-max px-4 py-3 text-[13px];
-}
-
-.code-block > .shiki {
-  @apply my-0 rounded-none border-0;
-}
-
-.code-block > button {
-  @apply absolute right-2.5 top-2.5;
-}
-
-.code-block button,
-.code-group button[aria-label='Copy code'],
-.preview button[aria-label='Copy code'] {
-  @apply flex size-6 shrink-0 items-center justify-center rounded-md text-muted-foreground outline-none hover:bg-accent hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 dark:hover:bg-accent/50 [&_svg]:size-4;
-}
-
-.code-block > header > button,
-.code-group > header > button,
-.preview > header > button {
-  @apply ml-auto;
-}
-
-.code-group {
-  @apply relative my-6 max-w-full overflow-hidden rounded-lg;
-}
-
-.code-group > header > .tabs {
-  @apply my-0 min-w-0 max-w-full gap-0;
-}
-
-.code-group > header > .tabs > nav {
-  @apply h-full justify-start rounded-none bg-transparent p-0;
-}
-
-.code-group > [role='tabpanel'] {
-  @apply border-t-0;
-}
-
-.code-group .code-block {
-  @apply my-0 min-w-0 rounded-none;
-}
-
-.code-group .code-block > header {
-  @apply hidden;
-}
-
-.preview {
-  @apply relative my-6 max-w-full overflow-hidden rounded-lg border border-border/50 bg-muted dark:bg-muted/50;
-}
-
-.preview > header > .tabs {
-  @apply my-0 min-w-0 max-w-full gap-0;
-}
-
-.preview > header > .tabs > nav {
-  @apply h-full justify-start rounded-none bg-transparent p-0;
-}
-
-.preview > [role='tabpanel'] {
-  @apply border-t-0;
-}
-
-.preview > [data-code-panel] .code-block {
-  @apply my-0 min-w-0 rounded-none;
-}
-
-.preview > header > button[aria-label='Copy code'] {
-  display: none;
-}
-
-.preview:has(> [data-code-panel]:not([hidden])) > header > button[aria-label='Copy code'] {
-  display: flex;
-}
-
-.preview > [data-preview-panel] > div {
-  @apply flex min-h-64 w-full items-center justify-center bg-muted p-6 dark:bg-muted/50;
-}
-
-.steps {
-  @apply mb-12 mt-6 md:ml-4 md:border-l md:pl-8;
-  counter-reset: step;
-}
-
-.steps > section {
-  counter-increment: step;
-}
-
-.steps > section > h3 {
-  @apply relative mt-12 scroll-m-28 text-lg font-medium tracking-tight;
-}
-
-.steps > section:first-child > h3 {
-  @apply mt-0;
-}
-
-.steps > section > h3::before {
-  @apply mr-4 inline-flex size-7 items-center justify-center rounded-full bg-muted text-sm font-medium text-muted-foreground;
-  content: counter(step);
-}
-
-@media (width >= 48rem) {
-  .steps > section > h3::before {
-    position: absolute;
-    left: 0;
-    top: 0;
-    margin-right: 0;
-    transform: translateX(-2.875rem);
-  }
-}
-
-.steps > section > * + * {
-  @apply mt-6;
-}
-
-.steps > section > h3 + * {
-  @apply mt-4;
-}
-
-.steps > section > * {
-  @apply leading-relaxed;
-}
-
-.steps > section > *:first-child {
-  @apply mt-0;
-}
-
-.steps > section > *:last-child {
-  @apply mb-0;
-}
-
-.prose > .alert,
-.prose > .alert-destructive,
-.prose > .card,
-.prose > .grid,
-.prose > .tabs {
-  @apply my-6;
-}

package/src/runtime/components/CommandDialog.astro

@@ -16,7 +16,7 @@ const { indexUrl } = Astro.props;
 </div>
 
 <script>
-  import lunr from "lunr";
+  import lunrUrl from "lunr/lunr.js?url";
 
   const root = document.querySelector("[data-search]");
   const indexUrl = root?.getAttribute("data-index-url");
@@ -26,6 +26,7 @@ const { indexUrl } = Astro.props;
   const menu = dialog?.querySelector('[role="menu"]');
   const state = {
     loadPromise: null,
+    lunrPromise: null,
     index: null,
     documents: [],
     bySlug: new Map(),
@@ -197,14 +198,30 @@ const { indexUrl } = Astro.props;
     refreshCommand();
   }
 
+  function loadLunr() {
+    if (window.lunr) return Promise.resolve(window.lunr);
+    if (!state.lunrPromise) {
+      state.lunrPromise = new Promise((resolve, reject) => {
+        const script = document.createElement("script");
+        script.src = lunrUrl;
+        script.async = true;
+        script.onload = () => (window.lunr ? resolve(window.lunr) : reject(new Error("Failed to load lunr.")));
+        script.onerror = () => reject(new Error("Failed to load lunr."));
+        document.head.appendChild(script);
+      });
+    }
+    return state.lunrPromise;
+  }
+
   async function loadIndex() {
     if (state.index) return state;
-    if (!indexUrl) throw new Error("Missing RSD search index URL.");
+    if (!indexUrl) throw new Error("Missing reallysimpledocs search index URL.");
     if (!state.loadPromise) {
       renderLoading();
       state.loadPromise = fetch(indexUrl)
         .then((response) => response.json())
-        .then((data) => {
+        .then(async (data) => {
+          const lunr = await loadLunr();
           state.documents = data.documents || [];
           state.bySlug = new Map(state.documents.map((doc) => [doc.slug, doc]));
           state.index = lunr.Index.load(data.index);