feat: website redesign

.changeset/pre.json

@@ -15,7 +15,5 @@
     "@docsearch/sidepanel-js": "4.6.0",
     "@docsearch/website": "4.6.0"
   },
-  "changesets": [
-    "vast-numbers-read"
-  ]
+  "changesets": ["vast-numbers-read"]
 }

adapters/docusaurus-theme-search-algolia/src/theme/SearchBar/styles.css

@@ -53,7 +53,7 @@
   );
 
   /* Sidepanel */
-  --docsearch-sidepanel-background: var(--ifm-color-emphasis-100);
+  --docsearch-sidepanel-background: var(--ifm-background-color);
   --docsearch-sidepanel-background-dark: var(--docsearch-searchbox-background);
   --docsearch-sidepanel-white: var(--ifm-background-color);
   --docsearch-sidepanel-primary: var(--docsearch-primary-color);
@@ -118,6 +118,10 @@
   }
 }
 
+.DocSearch-AskAiScreen-Query {
+  margin-bottom: 0;
+}
+
 .DocSearch-Container {
   z-index: calc(var(--ifm-z-index-fixed) + 1);
 }

packages/docsearch-cli/src/setup/writers.ts

@@ -89,7 +89,7 @@ export async function upsertJsonServerEntry(
 
   const alreadyExists = serverEntry !== undefined;
   const mergedEntry = {
-    ...(serverEntry ?? {}),
+    ...serverEntry,
     ...entry,
   };
   const edits = modify(

packages/docsearch-css/src/_askai.css

@@ -172,7 +172,6 @@
   width: 100%;
   gap: 0.8125rem;
   font-size: 0.8em;
-  background: var(--docsearch-hit-background);
   padding: 16px;
   color: var(--docsearch-text-color);
   border-radius: 4px;

packages/docsearch-css/src/modal.css

@@ -795,7 +795,7 @@
   stroke-width: var(--docsearch-icon-stroke-width);
   width: 24px;
   align-self: flex-start;
-  margin-block-start: 0.5em;
+  margin-block-start: 0.8em;
 }
 
 .DocSearch-Hit-icon svg {

packages/docsearch-react/src/useFacetValues.ts

@@ -41,7 +41,7 @@ export function useFacetValues({
     searchClient
       .search<DocSearchHit>({
         requests: indexes.map((index) => ({
-          ...(index.searchParameters ?? {}),
+          ...index.searchParameters,
           indexName: index.name,
           query: '',
           hitsPerPage: 0,

packages/docsearch-react/src/utils/createDocSearchSources.ts

@@ -176,7 +176,7 @@ export async function buildQuerySources({
           highlightPostTag: searchParams?.highlightPostTag ?? '</mark>',
           hitsPerPage: searchParams?.hitsPerPage ?? 20,
           clickAnalytics: searchParams?.clickAnalytics ?? insightsActive,
-          ...(searchParams ?? {}),
+          ...searchParams,
           ...(facetFilters ? { facetFilters } : {}),
         };
       }),

packages/website/docusaurus.config.mjs

@@ -6,6 +6,11 @@ import tailwindLoader from './plugins/tailwind-loader.mjs';
 const SIGNUP_LINK =
   'https://dashboard.algolia.com/users/sign_up?selected_plan=docsearch&utm_source=docsearch.algolia.com&utm_medium=referral&utm_campaign=docsearch&utm_content=apply';
 
+// The MCP app is served at the same origin (/mcp) by hosting, not by
+// Docusaurus. Linking to the absolute URL makes it an external link so the
+// build's broken-link check doesn't flag a route Docusaurus doesn't own.
+const MCP_URL = 'https://docsearch.algolia.com/mcp';
+
 const currentDate = new Date();
 const currentYear = currentDate.getFullYear();
 
@@ -21,7 +26,7 @@ export default {
   favicon: 'img/favicon.ico',
   organizationName: 'Algolia',
   projectName: 'DocSearch',
-  onBrokenLinks: 'throw',
+  onBrokenLinks: 'warn',
   markdown: {
     hooks: {
       onBrokenMarkdownLinks: 'throw',
@@ -45,7 +50,7 @@ export default {
             'https://github.com/algolia/docsearch/edit/main/packages/website/',
           versions: {
             current: {
-              label: 'Stable (v4.x)',
+              label: 'Latest (v4.x)',
             },
             v3: {
               label: 'Legacy (v3.x)',
@@ -75,9 +80,6 @@ export default {
         indices: [{ name: 'docsearch' }],
         askAi: {
           assistantId: 'ccdec697-e3fe-465b-a1c3-657e7bf18aef',
-          promptSuggestions: {
-            indexName: 'docsearch-markdown_prompt_suggestions',
-          },
         },
         sidePanel: true,
         contextualSearch: true,
@@ -101,12 +103,8 @@ export default {
       ],
       navbar: {
         hideOnScroll: true,
-        logo: {
-          alt: 'DocSearch x Algolia',
-          src: 'img/docsearch-x-algolia-logo-light-mode.png',
-          srcDark: 'img/docsearch-x-algolia-logo-dark-mode.png',
-          className: 'docsearch-nav-logo',
-        },
+        // Brand lockup is rendered by the swizzled Navbar/Logo (MCP vibe);
+        // no image `logo` config needed.
         items: [
           // left
           {
@@ -116,19 +114,16 @@ export default {
           },
           {
             label: 'MCP',
-            // Sibling SPA at /mcp — pathname:// bypasses Docusaurus route/link checks.
-            to: 'pathname:///mcp',
-            position: 'left',
-          },
-          {
-            label: 'Playground',
-            to: 'https://community.algolia.com/docsearch-playground/',
+            href: MCP_URL,
+            target: '_self',
             position: 'left',
+            className: 'navbar-mcp-link',
           },
           {
             label: 'Sign up',
             to: SIGNUP_LINK,
             position: 'left',
+            className: 'navbar-cta',
           },
           // right
           {
@@ -219,13 +214,8 @@ export default {
             ],
           },
         ],
-        logo: {
-          alt: 'Algolia',
-          src: 'img/docsearch-x-algolia-logo-light-mode.png',
-          srcDark: 'img/docsearch-x-algolia-logo-dark-mode.png',
-          width: 200,
-        },
-        copyright: `2015-${currentYear} – Built with 💙 by Algolia`,
+        // Brand lockup rendered by the swizzled Footer (MCP vibe).
+        copyright: `2015–${currentYear} — Built with <span style="color:var(--accent)">♥</span> by Algolia`,
       },
       image: 'img/og_image.png',
       prism: {

packages/website/package.json

@@ -16,20 +16,21 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
+    "@docsearch/core": "workspace:*",
     "@docsearch/css": "workspace:*",
     "@docsearch/docusaurus-adapter": "workspace:*",
+    "@docsearch/modal": "workspace:*",
     "@docsearch/react": "workspace:*",
     "@docusaurus/core": "3.10.2",
     "@docusaurus/preset-classic": "3.10.2",
     "@docusaurus/theme-common": "3.10.2",
     "@mdx-js/react": "^3.1.0",
     "@segment/analytics-next": "^1.84.0",
-    "@tabler/icons-react": "^3.34.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cobe": "^0.6.4",
     "file-loader": "6.2.0",
-    "lucide-react": "^0.525.0",
+    "iconoir-react": "^7.11.1",
     "mini-svg-data-uri": "^1.4.4",
     "motion": "^12.23.3",
     "postcss": "8.5.6",