docusaurus.config.ts

// Copyright © 2026 Ory Corp
// SPDX-License-Identifier: Apache-2.0

import type { Config } from "@docusaurus/types"
import type * as Preset from "@docusaurus/preset-classic"
import type * as OpenApiPlugin from "docusaurus-plugin-openapi-docs"

import lightTheme from "./src/utils/prismLight.mjs"
import darkTheme from "./src/utils/prismDark.mjs"
import { navbar } from "./src/navbar"
const config: Config = {
  customFields: {
    CLOUD_URL: process.env.CLOUD_URL || "https://api.console.ory:8080",
  },
  title: "Ory",
  tagline: "Open Source Identity and Access Infrastructure",
  url: `https://www.ory.com`,
  baseUrl: "/docs/",
  favicon: "img/favico.png",
  onBrokenLinks: "warn",
  onDuplicateRoutes: "throw",
  organizationName: "ory",
  projectName: "docs",
  trailingSlash: false,
  markdown: {
    format: "detect",
    hooks: {
      onBrokenMarkdownLinks: "warn",
    },
  },
  staticDirectories: ["src/static"],
  clientModules: [require.resolve("./src/clientModules/speedInsights.tsx")],
  themeConfig: {
    respectPrefersColorScheme: true,
    tableOfContents: {
      minHeadingLevel: 2,
      maxHeadingLevel: 4,
    },
    prism: {
      darkTheme: darkTheme,
      theme: lightTheme,
      additionalLanguages: [
        "json",
        "json5",
        "shell-session",
        "bash",
        "tsx",
        "markup-templating",
        "php",
        "yaml",
        "csharp",
        "diff",
        "http",
      ],
      magicComments: [
        {
          className: "theme-code-block-highlighted-line",
          line: "highlight-next-line",
          block: { start: "highlight-start", end: "highlight-end" },
        },
        {
          className: "code-block-delete-line",
          line: "delete-next-line",
          block: { start: "delete-lines-start", end: "delete-lines-end" },
        },
        {
          className: "code-block-add-line",
          line: "add-next-line",
          block: { start: "add-lines-start", end: "add-lines-end" },
        },
        {
          className: "copyright-2022-ory-corp",
          line: "Copyright © 2022 Ory Corp",
        },
        {
          className: "copyright-2023-ory-corp",
          line: "Copyright © 2023 Ory Corp",
        },
        {
          className: "spdx-license-identifier",
          line: "SPDX-License-Identifier: Apache-2.0",
        },
      ],
    } satisfies Preset.ThemeConfig["prism"],
    algolia: {
      appId: "V2EFIWEJ25",
      apiKey: "dc6b220f7d2bcd12da60b9cce431d8c5",
      indexName: "ory",
      contextualSearch: true,
    },
    navbar,
    footer: {
      style: "dark",
      copyright: `Copyright © ${new Date().getFullYear()} Ory Corp`,
      links: [
        {
          label: "Support?",
          href: "https://www.ory.com/support",
        },
        {
          label: "Search",
          href: "https://www.ory.com/docs/search",
        },
        {
          label: "Status",
          href: "https://status.ory.com",
        },
        {
          label: "Privacy",
          href: "https://www.ory.com/privacy",
        },
        {
          label: "Company",
          href: "https://www.ory.com/legal/company",
        },
        {
          label: "Terms of Service",
          href: "https://www.ory.com/tos",
        },
        {
          label: "Schedule a discovery call",
          href: "https://www.ory.com/contact",
        },
        {
          html: `<button onClick="window.__showOryConsentDialog()">Consent Preferences</button>`,
        },
      ] satisfies Preset.ThemeConfig["footer"]["links"],
      logo: {
        alt: "Ory logo in white",
        src: "/docs/img/logos/logo-ory-white-2022-11-04.svg",
        href: "https://www.ory.com/",
        height: 80,
        width: 130.7,
      },
    },
  } satisfies Preset.ThemeConfig,
  plugins: [
    // Not very useful and ruins page speed.
    //
    // [
    //   "docusaurus-pushfeedback",
    //   {
    //     project: "7bhe9sxlqg",
    //     buttonPosition: "center-right",
    //   },
    // ],
    "./src/plugins/preload-css",
    async function tailwindcss(context, options) {
      return {
        name: "docusaurus-tailwindcss",
        configurePostCss(postcssOptions) {
          postcssOptions.plugins.push(require("@tailwindcss/postcss"))
          return postcssOptions
        },
      }
    },

    [
      "@docusaurus/plugin-content-docs",
      {
        id: "default",
        path: "docs", // all product docs live here
        routeBasePath: "/", // gives URLs like /docs/xxx
        sidebarPath: require.resolve("./sidebars.ts"),
        editUrl: "https://github.com/ory/docs/edit/master",
        showLastUpdateAuthor: true,
        showLastUpdateTime: true,
        disableVersioning: false,
        include: ["**/*.md", "**/*.mdx", "**/*.jsx", "**/*.tsx"],
        docRootComponent: "@theme/DocRoot",
        docItemComponent: "@theme/ApiItem",
      },
    ],
    [
      "docusaurus-plugin-openapi-docs",
      {
        id: "openapi",
        docsPluginId: "default",
        config: {
          talos: {
            specPath: "docs/talos/reference/api.json",
            outputDir: "docs/talos/reference/api",
            sidebarOptions: { groupPathsBy: "tag" },
          } satisfies OpenApiPlugin.Options,
        },
      },
    ],

    "@docusaurus/plugin-content-pages",
    require.resolve("./src/plugins/docusaurus-polyfill"),
    require.resolve("./src/plugins/docusaurus-rate-limits-data/index.ts"),
    // require.resolve("./src/plugins/docusaurus-static-fonts"),
    [
      "@docusaurus/plugin-sitemap",
      {
        lastmod: "date",
      },
    ],
    [
      "@docusaurus/plugin-client-redirects",
      {
        redirects: [
          {
            from: "/quickstart/sdks",
            to: "/sdk",
          },
          {
            from: "/product-selector",
            to: "/welcome",
          },
        ],
      },
    ],
    [
      "@docusaurus/plugin-svgr",
      {
        svgrConfig: {},
      },
    ],
  ],
  presets: [
    [
      "redocusaurus",
      {
        specs: [
          {
            id: "ory-network-api",
            spec: "docs/reference/api.json",
          },
          {
            id: "polis-api",
            spec: "docs/polis/reference/api.json",
          },
        ],
        theme: {},
      },
    ],
  ],
  themes: [
    [
      "@docusaurus/theme-classic",
      {
        customCss: [require.resolve("./src/css/theme.css")],
      },
    ],
    "@docusaurus/theme-search-algolia",
    "docusaurus-theme-redoc",
    "docusaurus-theme-openapi-docs",
  ],
  headTags: [],
}

module.exports = config