need help migrating Built-in Search to static

[ghost]

hello, I'm trying to set up the static export, especially with the search via the app/api/search/route.ts file

I configured the file according to the documentation

but at the build I have this error

Error: Cannot find structured data from page, please define the page to index function

the content of the route.ts file

import { source } from "@/utils/content-loader/docs-loader";
import { createFromSource } from "fumadocs-core/search/server";

// it should be cached forever
export const revalidate = false;

console.log("source", source);
console.log("before createFromSource");
console.log("createFromSource", createFromSource(source));
console.log("after createFromSource");

export const { staticGET: GET } = createFromSource(source);

the content of the utils/content-loader/docs-loader.ts file

import { createMDXSource } from "fumadocs-mdx";
import type { InferMetaType, InferPageType } from "fumadocs-core/source";
import { loader } from "fumadocs-core/source";
import { icons } from "lucide-react";
//import { create } from "@/components/ui/icon";
import { createElement } from "react";

import { meta, docs, blogPosts } from "@/.source";

export const source = loader({
  baseUrl: "/docs",
  icon(icon) {
    if (icon && icon in icons)
      return createElement(icons[icon as keyof typeof icons]);
  },
  source: createMDXSource(docs, meta),
});

export const blog = loader({
  baseUrl: "/blog",
  source: createMDXSource(blogPosts),
});

export type Page = InferPageType<typeof source>;
export type Meta = InferMetaType<typeof source>;

with this logs:

> next build

   ▲ Next.js 15.1.6
   - Experiments (use with caution):
     · turbo

   Creating an optimized production build ...
[MDX] initialized map file
 ✓ Compiled successfully
   Linting and checking validity of types  .
 ⚠ The Next.js plugin was not detected in your ESLint configuration. See https://nextjs.org/docs/app/api-reference/config/eslint#migrating-existing-config
 ✓ Linting and checking validity of types    
   Collecting page data  ..source {
  _i18n: undefined,
  pageTree: { name: '', children: [ [Object], [Object], [Object], [Object] ] },
  getPages: [Function: getPages],
  getLanguages: [Function: getLanguages],
  getPage: [Function: getPage],
  getNodeMeta: [Function: getNodeMeta],
  getPageTree: [Function: getPageTree],
  getNodePage: [Function: getNodePage],
  generateParams: [Function: generateParams]
}
before createFromSource
Error: Cannot find structured data from page, please define the page to index function.
    at tZ (.next/server/app/api/search/route.js:4:49828)
    at <unknown> (.next/server/app/api/search/route.js:4:50574)
    at Array.map (<anonymous>)
    at tJ (.next/server/app/api/search/route.js:4:50567)
    at 31205 (.next/server/app/api/search/route.js:4:52079)
    at t (.next/server/webpack-runtime.js:1:128)
    at r (.next/server/app/api/search/route.js:4:61052)
    at <unknown> (.next/server/app/api/search/route.js:4:61099)
    at t.X (.next/server/webpack-runtime.js:1:1206)
    at <unknown> (.next/server/app/api/search/route.js:4:61065)

> Build error occurred
[Error: Failed to collect page data for /api/search] { type: 'Error' }

unfortunately I can't share all the source code
Do you have any idea what is wrong?

[fuma-nama]

Normally, page.data.structuredData should be defined, where the page is from source.getPages(). May I see your source.config.ts file?

[ghost]

yes of course

source.config.ts

import {
  defineConfig,
  defineDocs,
  defineCollections,
  frontmatterSchema,
  metaSchema,
} from "fumadocs-mdx/config";
import {
  rehypeCodeDefaultOptions,
  remarkImage,
  remarkHeading,
  remarkAdmonition,
} from "fumadocs-core/mdx-plugins";
import { remarkMermaid } from "@theguild/remark-mermaid";
import { transformerTwoslash } from "fumadocs-twoslash";
import rehypeKatex from "rehype-katex";
import { z } from "zod";

export const { docs, meta } = defineDocs({
  docs: {
    async: true,
    schema: frontmatterSchema.extend({
      preview: z.string().optional(),
      index: z.boolean().default(false),
      method: z.string().optional(),
    }),
  },
  meta: {
    schema: metaSchema.extend({
      description: z.string().optional(),
    }),
  },
});

export const blog = defineCollections({
  type: "doc",
  dir: "content/blog",
  async: true,
  schema: frontmatterSchema.extend({
    author: z.string(),
    date: z.string().date().or(z.date()).optional(),
  }),
});

export default defineConfig({
  // lastModifiedTime: "git",
  mdxOptions: {
    rehypeCodeOptions: {
      inline: "tailing-curly-colon",
      themes: {
        light: "catppuccin-latte",
        dark: "catppuccin-mocha",
      },
      transformers: [
        ...(rehypeCodeDefaultOptions.transformers ?? []),
        transformerTwoslash(),
        {
          name: "transformers:remove-notation-escape",
          code(hast: any) {
            for (const line of hast.children) {
              if (line.type !== "element") continue;

              const lastSpan = line.children.findLast(
                (v: any) => v.type === "element"
              );

              const head = lastSpan?.children[0];
              if (head?.type !== "text") return;

              head.value = head.value.replace(/\[\\!code/g, "[!code");
            }
          },
        },
      ],
    },
    remarkPlugins: [
      remarkMermaid,
      remarkHeading,
      remarkAdmonition,
      [remarkImage, { useImport: true }],
    ],
    rehypePlugins: (v: any) => [rehypeKatex, ...v],
    jsx: false,
  },
});

[fuma-nama]

Did you turn on async intentionally? It is still an internal feature.

If yes, you need to load all the pages ahead of time:

import { source } from '@/lib/source';
import { createSearchAPI } from 'fumadocs-core/search/server';
 
export const { GET } = createSearchAPI('advanced', {
  indexes: await Promise.all(source.getPages().map(async (page) => ({
    title: page.data.title,
    description: page.data.description,
    url: page.url,
    id: page.url,
    structuredData: (await page.data.load()).structuredData,
  }))),
});

Otherwise removing async: true should be able to fix your problem.

[ghost]

thank you, that's good!