Fix docs search.

[sbansal1999]

Description

This pull request improves the search API implementation for the docs application by switching to a more advanced and flexible search indexing approach. The changes include a complete rewrite of the search route to use structured data and asynchronous index building, as well as minor updates to type exports and documentation configuration.

Search API Improvements:

• Rewrote apps/docs/app/api/search/route.ts to use createSearchAPI with "advanced" indexes, building the indexes asynchronously from page data and leveraging the structure function with remark-mdx for better structured search results.
• Added a postprocess configuration in apps/docs/source.config.ts to include processed markdown in the documentation source, enabling richer data for indexing.

Type and Data Flow Updates:

• Exported the AsyncPageData type from apps/docs/app/docs/[[...slug]]/page.tsx to allow its use in the new search route implementation. (apps/docs/app/docs/[[...slug]]/page.tsxL11-R11)

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

Summary by CodeRabbit

• Improvements

  • Search now uses an enhanced, asynchronously-built index for more accurate and responsive results.
  • GET requests for search are handled asynchronously for smoother search behavior.

• Documentation

  • Page data type made publicly available to improve tooling and integrations.
  • Docs pipeline updated to include already-processed Markdown for richer content rendering.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

@sbansal1999 is attempting to deploy a commit to the Databuddy OSS Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Walkthrough

Search initialization refactored to an async index-building flow that enumerates pages, processes MDX, and constructs AdvancedIndex entries. GET handler now awaits lazy-built search API. AsyncPageData was exported. Docs config adds postprocessing with processed Markdown included.

Changes

Cohort / File(s)	Summary
Search API Refactoring apps/docs/app/api/search/route.ts	Replaced synchronous createFromSource usage with an async buildIndexes() that enumerates pages, runs MDX processing (structure() + remark-mdx), and creates AdvancedIndex entries. Introduced getSearchAPI() that lazily builds indexes and initializes createSearchAPI("advanced", { indexes }). Converted GET handler to async and delegate to the initialized API. Updated imports accordingly.
Type Export Change apps/docs/app/docs/[[...slug]]/page.tsx	Made AsyncPageData an exported type (export type AsyncPageData = ...) without changing its fields.
Configuration Update apps/docs/source.config.ts	Added a postprocess block under docs with includeProcessedMarkdown: true to include already-processed Markdown in the docs pipeline.

Sequence Diagram(s)

sequenceDiagram
    autonumber
    participant Client as Client (browser)
    participant Route as /api/search (GET)
    participant Indexer as buildIndexes()
    participant MDX as structure() + remark-mdx
    participant API as createSearchAPI("advanced")

    Client->>Route: GET /api/search
    Route->>Indexer: ensure indexes built (await)
    Indexer->>MDX: enumerate pages, parse MDX
    MDX-->>Indexer: structured data per page
    Indexer->>API: initialize with indexes
    API-->>Route: search handler ready
    Route->>API: delegate GET(request)
    API-->>Client: search results

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Pre-merge checks and finishing touches

❌ Failed checks (1 warning, 1 inconclusive)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.
Title check	❓ Inconclusive	The title 'Fix docs search' is vague and generic, lacking specificity about what search issue is being addressed or how it's being fixed.	Consider a more descriptive title that explains the actual change, such as 'Refactor docs search with advanced indexing' or 'Implement asynchronous search indexing for docs'.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4a04843 and e26e17c.

📒 Files selected for processing (3)

• apps/docs/app/api/search/route.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts

🧰 Additional context used

📓 Path-based instructions (14)

**/*.{ts,tsx,js,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx,vue}: Never block paste in <input> or <textarea> elements
Enter submits focused text input; in <textarea>, ⌘/Ctrl+Enter submits; Enter adds newline
Compatible with password managers and 2FA; allow pasting one-time codes

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx}: Trim values to handle text expansion and trailing spaces in form submissions
URL reflects state (deep-link filters/tabs/pagination/expanded panels); prefer libraries like nuqs
Back/Forward buttons restore scroll position
Delay first tooltip in a group; subsequent peers have no delay
Use locale-aware formatting for dates, times, numbers, and currency
Batch layout reads/writes; avoid unnecessary reflows/repaints
Virtualize large lists using libraries like virtua

**/*.{ts,tsx,js,jsx}: Don't use accessKey attribute on any HTML element.
Don't set aria-hidden="true" on focusable elements.
Don't add ARIA roles, states, and properties to elements that don't support them.
Don't use distracting elements like <marquee> or <blink>.
Only use the scope prop on <th> elements.
Don't assign non-interactive ARIA roles to interactive HTML elements.
Make sure label elements have text content and are associated with an input.
Don't assign interactive ARIA roles to non-interactive HTML elements.
Don't assign tabIndex to non-interactive HTML elements.
Don't use positive integers for tabIndex property.
Don't include "image", "picture", or "photo" in img alt prop.
Don't use explicit role property that's the same as the implicit/default role.
Make static elements with click handlers use a valid role attribute.
Always include a title element for SVG elements.
Give all elements requiring alt text meaningful information for screen readers.
Make sure anchors have content that's accessible to screen readers.
Assign tabIndex to non-interactive HTML elements with aria-activedescendant.
Include all required ARIA attributes for elements with ARIA roles.
Make sure ARIA properties are valid for the element's supported roles.
Always include a type attribute for button elements.
Make elements with interactive roles and handlers focusable.
Give heading elements content that's accessible to screen readers (not hidden with aria-hidden).
Always include...

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx,js,jsx,css,scss,sass,less}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx,css,scss,sass,less}: During drag operations, disable text selection and set inert on dragged element and containers
Animations must be interruptible and input-driven; avoid autoplay

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

**/*.{ts,tsx,jsx}: Use semantic elements instead of role attributes in JSX.
Don't use unnecessary fragments.
Don't pass children as props.
Don't use the return value of React.render.
Make sure all dependencies are correctly specified in React hooks.
Make sure all React hooks are called from the top level of component functions.
Don't forget key props in iterators and collection literals.
Don't destructure props inside JSX components in Solid projects.
Don't define React components inside other components.
Don't use event handlers on non-interactive elements.
Don't assign to React component props.
Don't use both children and dangerouslySetInnerHTML props on the same element.
Don't use dangerous JSX props.
Don't use Array index in keys.
Don't insert comments as text nodes.
Don't assign JSX properties multiple times.
Don't add extra closing tags for components without children.
Use <>...</> instead of <Fragment>...</Fragment>.
Watch out for possible "wrong" semicolons inside JSX elements.
Make sure void (self-closing) elements don't have children.
Don't use target="_blank" without rel="noopener".
Don't use <img> elements in Next.js projects.
Don't use <head> elements in Next.js projects.

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

**/*.{ts,tsx}: Don't use primitive type aliases or misleading types.
Don't use empty type parameters in type aliases and interfaces.
Don't use any or unknown as type constraints.
Don't return a value from a function with the return type 'void'.
Don't use the TypeScript directive @ts-ignore.
Don't use TypeScript enums.
Don't add type annotations to variables, parameters, and class properties that are initialized with literal expressions.
Don't use TypeScript namespaces.
Don't use non-null assertions with the ! postfix operator.
Don't use parameter properties in class constructors.
Don't use user-defined types.
Use as const instead of literal types and type annotations.
Use either T[] or Array<T> consistently.
Initialize each enum member value explicitly.
Use export type for types.
Use import type for types.
Make sure all enum members are literal values.
Don't use TypeScript const enum.
Don't declare empty interfaces.
Don't let variables evolve into any type through reassignments.
Don't use the any type.
Don't misuse the non-null assertion operator (!) in TypeScript files.
Don't use implicit any type on variable declarations.
Don't merge interfaces and classes unsafely.
Don't use overload signatures that aren't next to each other.
Use the namespace keyword instead of the module keyword to declare TypeScript namespaces.
Use consistent accessibility modifiers on class properties and methods.
Use function types instead of object types with call signatures.
Don't use void type outside of generic or return types.

**/*.{ts,tsx}: Do NOT use types 'any', 'unknown' or 'never'. Use proper explicit types
Suffix functions with 'Action' in types, like 'type Test = { testAction }'

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

!(**/pages/_document.{ts,tsx,jsx})**/*.{ts,tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

Don't import next/document outside of pages/_document.jsx in Next.js projects.

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx,html,css}

📄 CodeRabbit inference engine (.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc)

Use bun build <file.html|file.ts|file.css> instead of webpack or esbuild for bundling

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{js,jsx,ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

**/*.{js,jsx,ts,tsx}: Split off components, utils, and reusable code to ensure better loading speed and less complexity
Use lower-case-like-this naming convention for variables, functions, and identifiers
NEVER add placeholders, mock data, or anything similar to production code
Use Dayjs for date handling, NEVER use date-fns. Use Tanstack query for hooks, NEVER use SWR
Use json.stringify() when adding debugging code
Never use barrel exports or create index files

Files:

• apps/docs/source.config.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/app/api/search/route.ts

**/*.{js,ts}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

Handle complex data transformations independently of React. Keep modules decoupled from React for improved modularity and testability

Files:

• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{html,htm,tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{html,htm,tsx,jsx,vue}: Use autocomplete attribute with meaningful name; use correct type and inputmode
Disable spellcheck for email/code/username inputs using spellcheck="false"
Links are <a> or <Link> components for navigation; support Cmd/Ctrl/middle-click
Use polite aria-live for toasts and inline validation feedback
Autofocus on desktop when there's a single primary input; rarely on mobile to avoid layout shift
<title> tag must match current context
Use redundant status cues (not color-only); icon-only elements have text labels
Use accurate accessible names via aria-label; mark decorative elements with aria-hidden; verify in Accessibility Tree
Icon-only buttons must have descriptive aria-label
Prefer native semantics (button, a, label, table) before ARIA
Use non-breaking spaces to glue terms: 10 MB, ⌘ + K, Vercel SDK
Preload only above-the-fold images; lazy-load the rest

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{css,scss,sass,less,html,htm,tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{css,scss,sass,less,html,htm,tsx,jsx,vue}: No dead zones on checkboxes/radios; label and control share one generous hit target
Use scroll-margin-top on headings for anchored links; include 'Skip to content' link; use hierarchical <h1>–<h6>
Prevent Cumulative Layout Shift (CLS) from images by using explicit dimensions or reserved space

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

Don't ship the schema—visuals may omit labels but accessible names must still exist

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

Prefer uncontrolled inputs; make controlled loops cheap (optimize keystroke cost)

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{jsx,tsx}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

**/*.{jsx,tsx}: When using 'text-right' utility class, always add 'text-balance' to prevent poor text layout
Think about mobile responsiveness when doing any UI tasks or changes
Always use 'rounded' Tailwind class, never 'rounded-xl' or 'rounded-md'
Don't use lucide for icons, ONLY use phosphor icons. Use width='duotone' for most icons, use fill for arrows, and don't add width attribute for plus icons
Decouple state management, data transformations, and API interactions from the React lifecycle in View Components
Simplify data flow to eliminate prop drilling and callback hell in components
Prioritize modularity and testability in all components
ALWAYS use error boundaries properly in React applications
Use 'Icon' suffix at the end of phosphor react icon imports, like CaretIcon not Caret. This is the default import, NOT as a named import
Almost NEVER use useEffect unless it's critical

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

🧠 Learnings (1)

📚 Learning: 2025-12-02T22:57:07.791Z

Learnt from: CR
Repo: databuddy-analytics/Databuddy PR: 0
File: .cursor/rules/ultracite.mdc:0-0
Timestamp: 2025-12-02T22:57:07.791Z
Learning: Applies to **/*.{ts,tsx} : Use `export type` for types.

Applied to files:

• apps/docs/app/docs/[[...slug]]/page.tsx

🔇 Additional comments (5)

apps/docs/app/docs/[[...slug]]/page.tsx (1)

11-15: LGTM! Type export follows guidelines.

Exporting AsyncPageData enables its use in the search API route while maintaining type safety. The change correctly uses export type as specified in the coding guidelines.

apps/docs/app/api/search/route.ts (3)

1-8: LGTM! Imports are correctly structured.

All imports are used appropriately, and the type import on line 7 correctly uses the type keyword as per coding guidelines.

---

34-40: LGTM! Lazy initialization pattern is correct.

The caching pattern appropriately avoids rebuilding indexes on each request. Once the buildIndexes function is optimized for parallel processing, this will work efficiently.

---

42-45: LGTM! GET handler correctly implements async pattern.

The handler properly awaits the search API initialization and delegates the request handling. The conversion to an async function is necessary and correctly implemented.

apps/docs/source.config.ts (1)

8-10: The postprocess.includeProcessedMarkdown: true configuration is valid and documented in fumadocs-mdx version 14. This setting correctly enables the getText("processed") method used in search indexing. No changes needed.

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e26e17c and 286ef0e.

📒 Files selected for processing (3)

• apps/docs/app/api/search/route.ts
• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts

🧰 Additional context used

📓 Path-based instructions (14)

**/*.{ts,tsx,js,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx,vue}: Never block paste in <input> or <textarea> elements
Enter submits focused text input; in <textarea>, ⌘/Ctrl+Enter submits; Enter adds newline
Compatible with password managers and 2FA; allow pasting one-time codes

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{html,htm,tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{html,htm,tsx,jsx,vue}: Use autocomplete attribute with meaningful name; use correct type and inputmode
Disable spellcheck for email/code/username inputs using spellcheck="false"
Links are <a> or <Link> components for navigation; support Cmd/Ctrl/middle-click
Use polite aria-live for toasts and inline validation feedback
Autofocus on desktop when there's a single primary input; rarely on mobile to avoid layout shift
<title> tag must match current context
Use redundant status cues (not color-only); icon-only elements have text labels
Use accurate accessible names via aria-label; mark decorative elements with aria-hidden; verify in Accessibility Tree
Icon-only buttons must have descriptive aria-label
Prefer native semantics (button, a, label, table) before ARIA
Use non-breaking spaces to glue terms: 10 MB, ⌘ + K, Vercel SDK
Preload only above-the-fold images; lazy-load the rest

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx}: Trim values to handle text expansion and trailing spaces in form submissions
URL reflects state (deep-link filters/tabs/pagination/expanded panels); prefer libraries like nuqs
Back/Forward buttons restore scroll position
Delay first tooltip in a group; subsequent peers have no delay
Use locale-aware formatting for dates, times, numbers, and currency
Batch layout reads/writes; avoid unnecessary reflows/repaints
Virtualize large lists using libraries like virtua

**/*.{ts,tsx,js,jsx}: Don't use accessKey attribute on any HTML element.
Don't set aria-hidden="true" on focusable elements.
Don't add ARIA roles, states, and properties to elements that don't support them.
Don't use distracting elements like <marquee> or <blink>.
Only use the scope prop on <th> elements.
Don't assign non-interactive ARIA roles to interactive HTML elements.
Make sure label elements have text content and are associated with an input.
Don't assign interactive ARIA roles to non-interactive HTML elements.
Don't assign tabIndex to non-interactive HTML elements.
Don't use positive integers for tabIndex property.
Don't include "image", "picture", or "photo" in img alt prop.
Don't use explicit role property that's the same as the implicit/default role.
Make static elements with click handlers use a valid role attribute.
Always include a title element for SVG elements.
Give all elements requiring alt text meaningful information for screen readers.
Make sure anchors have content that's accessible to screen readers.
Assign tabIndex to non-interactive HTML elements with aria-activedescendant.
Include all required ARIA attributes for elements with ARIA roles.
Make sure ARIA properties are valid for the element's supported roles.
Always include a type attribute for button elements.
Make elements with interactive roles and handlers focusable.
Give heading elements content that's accessible to screen readers (not hidden with aria-hidden).
Always include...

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{css,scss,sass,less,html,htm,tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{css,scss,sass,less,html,htm,tsx,jsx,vue}: No dead zones on checkboxes/radios; label and control share one generous hit target
Use scroll-margin-top on headings for anchored links; include 'Skip to content' link; use hierarchical <h1>–<h6>
Prevent Cumulative Layout Shift (CLS) from images by using explicit dimensions or reserved space

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{ts,tsx,js,jsx,css,scss,sass,less}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

**/*.{ts,tsx,js,jsx,css,scss,sass,less}: During drag operations, disable text selection and set inert on dragged element and containers
Animations must be interruptible and input-driven; avoid autoplay

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{tsx,jsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

Don't ship the schema—visuals may omit labels but accessible names must still exist

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/guidelines.mdc)

Prefer uncontrolled inputs; make controlled loops cheap (optimize keystroke cost)

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{ts,tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

**/*.{ts,tsx,jsx}: Use semantic elements instead of role attributes in JSX.
Don't use unnecessary fragments.
Don't pass children as props.
Don't use the return value of React.render.
Make sure all dependencies are correctly specified in React hooks.
Make sure all React hooks are called from the top level of component functions.
Don't forget key props in iterators and collection literals.
Don't destructure props inside JSX components in Solid projects.
Don't define React components inside other components.
Don't use event handlers on non-interactive elements.
Don't assign to React component props.
Don't use both children and dangerouslySetInnerHTML props on the same element.
Don't use dangerous JSX props.
Don't use Array index in keys.
Don't insert comments as text nodes.
Don't assign JSX properties multiple times.
Don't add extra closing tags for components without children.
Use <>...</> instead of <Fragment>...</Fragment>.
Watch out for possible "wrong" semicolons inside JSX elements.
Make sure void (self-closing) elements don't have children.
Don't use target="_blank" without rel="noopener".
Don't use <img> elements in Next.js projects.
Don't use <head> elements in Next.js projects.

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

**/*.{ts,tsx}: Don't use primitive type aliases or misleading types.
Don't use empty type parameters in type aliases and interfaces.
Don't use any or unknown as type constraints.
Don't return a value from a function with the return type 'void'.
Don't use the TypeScript directive @ts-ignore.
Don't use TypeScript enums.
Don't add type annotations to variables, parameters, and class properties that are initialized with literal expressions.
Don't use TypeScript namespaces.
Don't use non-null assertions with the ! postfix operator.
Don't use parameter properties in class constructors.
Don't use user-defined types.
Use as const instead of literal types and type annotations.
Use either T[] or Array<T> consistently.
Initialize each enum member value explicitly.
Use export type for types.
Use import type for types.
Make sure all enum members are literal values.
Don't use TypeScript const enum.
Don't declare empty interfaces.
Don't let variables evolve into any type through reassignments.
Don't use the any type.
Don't misuse the non-null assertion operator (!) in TypeScript files.
Don't use implicit any type on variable declarations.
Don't merge interfaces and classes unsafely.
Don't use overload signatures that aren't next to each other.
Use the namespace keyword instead of the module keyword to declare TypeScript namespaces.
Use consistent accessibility modifiers on class properties and methods.
Use function types instead of object types with call signatures.
Don't use void type outside of generic or return types.

**/*.{ts,tsx}: Do NOT use types 'any', 'unknown' or 'never'. Use proper explicit types
Suffix functions with 'Action' in types, like 'type Test = { testAction }'

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

!(**/pages/_document.{ts,tsx,jsx})**/*.{ts,tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/ultracite.mdc)

Don't import next/document outside of pages/_document.jsx in Next.js projects.

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{ts,tsx,html,css}

📄 CodeRabbit inference engine (.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc)

Use bun build <file.html|file.ts|file.css> instead of webpack or esbuild for bundling

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{jsx,tsx}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

**/*.{jsx,tsx}: When using 'text-right' utility class, always add 'text-balance' to prevent poor text layout
Think about mobile responsiveness when doing any UI tasks or changes
Always use 'rounded' Tailwind class, never 'rounded-xl' or 'rounded-md'
Don't use lucide for icons, ONLY use phosphor icons. Use width='duotone' for most icons, use fill for arrows, and don't add width attribute for plus icons
Decouple state management, data transformations, and API interactions from the React lifecycle in View Components
Simplify data flow to eliminate prop drilling and callback hell in components
Prioritize modularity and testability in all components
ALWAYS use error boundaries properly in React applications
Use 'Icon' suffix at the end of phosphor react icon imports, like CaretIcon not Caret. This is the default import, NOT as a named import
Almost NEVER use useEffect unless it's critical

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx

**/*.{js,jsx,ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

**/*.{js,jsx,ts,tsx}: Split off components, utils, and reusable code to ensure better loading speed and less complexity
Use lower-case-like-this naming convention for variables, functions, and identifiers
NEVER add placeholders, mock data, or anything similar to production code
Use Dayjs for date handling, NEVER use date-fns. Use Tanstack query for hooks, NEVER use SWR
Use json.stringify() when adding debugging code
Never use barrel exports or create index files

Files:

• apps/docs/app/docs/[[...slug]]/page.tsx
• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

**/*.{js,ts}

📄 CodeRabbit inference engine (.cursor/rules/01-MUST-DO.mdc)

Handle complex data transformations independently of React. Keep modules decoupled from React for improved modularity and testability

Files:

• apps/docs/source.config.ts
• apps/docs/app/api/search/route.ts

🧠 Learnings (4)

📚 Learning: 2025-12-02T22:57:07.791Z

Learnt from: CR
Repo: databuddy-analytics/Databuddy PR: 0
File: .cursor/rules/ultracite.mdc:0-0
Timestamp: 2025-12-02T22:57:07.791Z
Learning: Applies to **/*.{ts,tsx} : Use `export type` for types.

Applied to files:

• apps/docs/app/docs/[[...slug]]/page.tsx

📚 Learning: 2025-12-02T22:57:07.791Z

Learnt from: CR
Repo: databuddy-analytics/Databuddy PR: 0
File: .cursor/rules/ultracite.mdc:0-0
Timestamp: 2025-12-02T22:57:07.791Z
Learning: Applies to **/*.{ts,tsx,js,jsx} : Don't use await inside loops.

Applied to files:

• apps/docs/app/api/search/route.ts

📚 Learning: 2025-12-02T22:57:07.791Z

Learnt from: CR
Repo: databuddy-analytics/Databuddy PR: 0
File: .cursor/rules/ultracite.mdc:0-0
Timestamp: 2025-12-02T22:57:07.791Z
Learning: Applies to **/*.{ts,tsx,js,jsx} : Don't use async functions as Promise executors.

Applied to files:

• apps/docs/app/api/search/route.ts

📚 Learning: 2025-12-02T22:57:07.791Z

Learnt from: CR
Repo: databuddy-analytics/Databuddy PR: 0
File: .cursor/rules/ultracite.mdc:0-0
Timestamp: 2025-12-02T22:57:07.791Z
Learning: Applies to **/*.{ts,tsx,js,jsx} : Make sure async functions actually use await.

Applied to files:

• apps/docs/app/api/search/route.ts

🧬 Code graph analysis (1)

apps/docs/app/api/search/route.ts (2)

apps/docs/lib/source.ts (1)

• source (4-7)

apps/docs/app/docs/[[...slug]]/page.tsx (1)

• AsyncPageData (11-15)

🔇 Additional comments (6)

apps/docs/source.config.ts (1)

8-10: LGTM! Configuration enables processed markdown for indexing.

The postprocess configuration correctly enables inclusion of processed markdown content, which supports the new advanced search indexing flow.

apps/docs/app/docs/[[...slug]]/page.tsx (1)

11-11: LGTM! Correctly exports the type for reuse.

The type is properly exported using export type, following coding guidelines and enabling type sharing with the search API module.

apps/docs/app/api/search/route.ts (4)

1-10: LGTM! Imports and route configuration are correct.

The imports are appropriate for the advanced search implementation. Note that dynamic = "force-dynamic" ensures the search API always returns fresh results, which is appropriate for a search endpoint.

---

13-13: LGTM! Lazy initialization pattern is appropriate.

The nullable lazy initialization pattern with explicit typing correctly prevents build-time errors from async source operations.

---

45-51: LGTM! Lazy initialization optimizes performance.

The function correctly implements lazy initialization with caching, ensuring search indexes are built only once and reused across requests.

---

53-56: LGTM! GET handler correctly implements async pattern.

The handler properly awaits API initialization and delegates to the search API, following Next.js 15 async route handler patterns.