vercel__flags/apps/docs/source.config.ts

import { remarkMdxMermaid } from "fumadocs-core/mdx-plugins";
import {
  defineConfig,
  defineDocs,
  frontmatterSchema,
  metaSchema,
} from "fumadocs-mdx/config";
import { z } from "zod";

// You can customise Zod schemas for frontmatter and `meta.json` here
// see https://fumadocs.dev/docs/mdx/collections
export const docs = defineDocs({
  dir: "content/docs",
  docs: {
    schema: frontmatterSchema.extend({
      product: z.string().optional(),
      url: z
        .string()
        .regex(/^\/.*/, { message: "url must start with a slash" })
        .optional(),
      type: z.enum([
        "conceptual",         // Explains what something is and why it exists. Architecture, mental models, design decisions.
        "guide",              // Walks through how to accomplish a goal. Tutorials, getting started, workflows.
        "reference",          // Lookup-oriented, exhaustive details. API docs, config options, function signatures.
        "troubleshooting",    // Diagnoses problems and solutions. FAQs, errors, known issues, debugging guides.
        "integration",        // Connects multiple systems. 3rd-party setup, plugins, webhooks, migrations.
        "overview"            // High-level introductions. Landing pages, changelogs, release notes.
      ]).optional(),
      prerequisites: z.array(z.string().regex(/^\/.*/, { message: "prerequisites must start with a slash" })).optional(),
      related: z.array(z.string().regex(/^\/.*/, { message: "related must start with a slash" })).optional(),
      summary: z.string().optional(),
    }),
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
  meta: {
    schema: metaSchema
  },
});

export default defineConfig({
  mdxOptions: {
    remarkPlugins: [remarkMdxMermaid],
  },
  plugins: [],
});