docusaurus.config.js

const path = require("path");
require("dotenv").config();
const githubOrg = "web3auth";
const githubRepo = "web3auth-docs";
const githubOrgUrl = `https://github.com/${githubOrg}`;
const githubRepoUrl = `${githubOrgUrl}/${githubRepo}`;
const githubEditUrl = `${githubRepoUrl}/edit/master`;
const remarkMath = require("remark-math");
const rehypeKatex = require("rehype-katex");
const fs = require("fs");
const baseUrl = process.env.REACT_APP_BASE_URL || "/docs/";

const resourcesDropdown = fs.readFileSync("./src/components/navDropdown/resources.html", "utf-8");
const helpDropdown = fs.readFileSync("./src/components/navDropdown/help.html", "utf-8");
const sdkDropdown = fs.readFileSync("./src/components/navDropdown/sdk.html", "utf-8");
const contentHubDropdown = fs.readFileSync("./src/components/navDropdown/content-hub.html", "utf-8");

/** @type {import('@docusaurus/types').DocusaurusConfig} */
const config = {
  title: "Documentation | Web3Auth",
  tagline: "Web3 Auth and Wallet Management (WaaS) SDKs with MPC", // TODO: Confirm with content team
  url: "https://web3auth.io",
  baseUrl,
  onBrokenLinks: "warn",
  onBrokenMarkdownLinks: "warn",
  onDuplicateRoutes: "warn",
  favicon: "images/favicon.ico",
  organizationName: githubOrg,
  projectName: githubRepo,
  themeConfig: {
    docs: {
      sidebar: {
        autoCollapseCategories: true,
        hideable: true,
      },
    },
    announcementBar: {
      id: "sign_up_for_wallets_ux_unconference",
      content: '<a href="https://w3a.link/community-call" target="_blank">Secure your spot for the next community call! Sign up now →</a>',
      isCloseable: true,
    },
    colorMode: {
      defaultMode: "dark",
      disableSwitch: false,
      respectPrefersColorScheme: true,
    },
    prism: {
      additionalLanguages: ["groovy", "java", "kotlin", "swift", "dart", "csharp"],
    },
    navbar: {
      title: "Documentation",
      logo: {
        alt: "Web3Auth's Logo",
        src: "images/documentation-logo.svg",
        srcDark: "images/documentation-logo-dark.svg",
        target: "_self",
      },
      items: [
        {
          label: "SDKs",
          type: "dropdown",
          to: "/sdk",
          position: "left",
          items: [
            {
              type: "html",
              value: sdkDropdown,
            },
          ],
        },
        {
          label: "Resources",
          type: "dropdown",
          position: "left",
          items: [
            {
              type: "html",
              value: resourcesDropdown,
            },
          ],
        },
        {
          label: "Quick Start",
          to: "/quick-start",
          position: "left",
        },
        {
          label: "Content Hub",
          type: "dropdown",
          to: "/content-hub",
          position: "left",
          items: [
            {
              type: "html",
              value: contentHubDropdown,
            },
          ],
        },
        {
          label: "Help",
          type: "dropdown",
          position: "left",
          items: [
            {
              type: "html",
              value: helpDropdown,
            },
          ],
        },
        // {
        //   position: "right",
        //   href: githubOrgUrl,
        //   className: "navbar-github-link",
        //   "aria-label": "GitHub Organization",
        // },
        {
          type: "search",
          position: "right",
        },
        {
          type: "html",
          position: "right",
          value:
            '<a href="https://dashboard.web3auth.io/" target="_blank" class="navbar-button"><strong class="navbar-button-text">Login to Dashboard</strong></a>',
        },
        {
          type: "html",
          position: "right",
          value: "<div></div>",
        },
      ],
    },
    algolia: {
      appId: "6OF28D8CMV",
      apiKey: "425a1e860cb4b9b4ce1f7d9b117c7a81",
      indexName: "docs-web3auth",
      schedule: "every 1 day at 3:00 pm",
    },
    customFields: {
      baseUrl,
    },
  },
  scripts: [
    {
      src: baseUrl + "js/fix-trailing-slash.js",
      async: false,
      defer: false,
    },
  ],
  presets: [
    [
      "@docusaurus/preset-classic",
      {
        docs: {
          routeBasePath: "/",
          breadcrumbs: false,
          editUrl: githubEditUrl,
          sidebarPath: require.resolve("./sidebars.js"),
          remarkPlugins: [remarkMath, [require("@docusaurus/remark-plugin-npm2yarn"), { sync: true }]],
          rehypePlugins: [[rehypeKatex, { strict: false }]],
        },
        theme: {
          customCss: require.resolve("./src/css/custom.css"),
        },
        gtag: {
          trackingID: "GTM-NFBSNHL",
        },
        pages: {
          path: "src/pages",
          routeBasePath: "/",
          include: ["**/**.{js,jsx,ts,tsx,md,mdx}"],
          exclude: ["**/_*.{js,jsx,ts,tsx,md,mdx}", "**/_*/**", "**/*.test.{js,jsx,ts,tsx}", "**/__tests__/**"],
          mdxPageComponent: "@theme/MDXPage",
          remarkPlugins: [remarkMath, [require("@docusaurus/remark-plugin-npm2yarn"), { sync: true }]],
          rehypePlugins: [[rehypeKatex, { strict: false }]],
          beforeDefaultRemarkPlugins: [],
          beforeDefaultRehypePlugins: [],
        },
        sitemap: {
          changefreq: "weekly",
          priority: 0.8,
        },
      },
    ],
  ],
  plugins: [
    path.resolve(__dirname, "plugins", "docusaurus-plugin-content-hub"),
    [path.resolve(__dirname, "plugins", "docusaurus-plugin-virtual-files"), { rootDir: "files" }],
    path.resolve(__dirname, "plugins", "node-polyfills"),
    [
      path.resolve(__dirname, "plugins", "plugin-dynamic-route"),
      {
        routes: [
          {
            path: `${baseUrl}content-hub/blog/`,
            exact: false,
            component: "@site/src/components/BlogLayout/index",
          },
        ],
      },
    ],
    [
      "@docusaurus/plugin-client-redirects",
      {
        redirects: [
          {
            from: "/examples/productionexamples",
            to: "/examples",
          },
          {
            from: "/get-started",
            to: "/quick-start",
          },
          {
            from: "/developing-with-web3auth/understand-sdk",
            to: "/quick-start",
          },
          {
            from: "/developing-with-web3auth/",
            to: "/quick-start",
          },
          {
            from: "/sdk/web/plugins/torus-wallet",
            to: "/sdk/helper-sdks/plugins/evm-wallet",
          },
          {
            from: "/sdk/web/modal/wagmi-connector",
            to: "/sdk/pnp/web/wagmi-connector",
          },
          {
            from: "/sdk/web/no-modal/wagmi-connector",
            to: "/sdk/pnp/web/wagmi-connector",
          },
          {
            from: "/quickstart",
            to: "/quick-start",
          },
          {
            from: "/sdk/web/choosesdk/",
            to: "/sdk/pnp/web/",
          },
          {
            from: "/sdk/android/setting-up",
            to: "/sdk/pnp/android/",
          },
          {
            from: "/sdk/ios/setting-up",
            to: "/sdk/pnp/ios/",
          },
          {
            from: "/sdk/flutter/setting-up",
            to: "/sdk/pnp/flutter/",
          },
          {
            from: "/sdk/react-native/choose-workflows",
            to: "/sdk/pnp/react-native/",
          },
          {
            from: "/sdk/web/customauth",
            to: "/sdk/pnp/web/no-modal/custom-authentication",
          },
          {
            from: "/overview/what-is-web3auth",
            to: "/what-is-web3auth",
          },
          {
            from: "/overview/how-web3auth-works",
            to: "/how-web3auth-works",
          },
          {
            from: "/overview/web3auth-and-wallets",
            to: "/product-fit/web3auth-for-wallets",
          },
          {
            from: "/overview/web3auth-for-wallets",
            to: "/product-fit/web3auth-for-wallets",
          },
          {
            from: "/overview/web3auth-for-dapps",
            to: "/product-fit/web3auth-for-dapps",
          },
          {
            from: "/overview/user-flow",
            to: "/user-flow",
          },
          {
            from: "/product-fit/user-flow",
            to: "/user-flow",
          },
          {
            from: "/overview/key-management/",
            to: "/infrastructure/",
          },
          {
            from: "/overview/key-management/technical-architecture/",
            to: "/infrastructure/",
          },
          {
            from: "/infrastructure/key-management",
            to: "/infrastructure/",
          },
          {
            from: "/infrastructure/technical-architecture/",
            to: "/infrastructure/",
          },
          {
            from: "/whitelabeling",
            to: "/pnp/features/whitelabel/",
          },
          {
            from: "/whitelabel/",
            to: "/pnp/features/whitelabel/",
          },
          {
            from: "/interoperability",
            to: "/pnp/features/interoperability",
          },
          {
            from: "/dapp-share",
            to: "/pnp/features/dapp-share",
          },
          {
            from: "/authenticating-users/",
            to: "/pnp/features/server-side-verification/",
          },
          {
            from: "/authenticating-users/overview",
            to: "/pnp/features/server-side-verification/",
          },
          {
            from: "/server-side-verification/",
            to: "/pnp/features/server-side-verification/",
          },
          {
            from: "/server-side-verification/social-login-users",
            to: "/pnp/features/server-side-verification/social-login-users",
          },
          {
            from: "/server-side-verification/external-wallets",
            to: "/pnp/features/server-side-verification/external-wallets",
          },
          {
            from: "/developing-with-web3auth/adapters",
            to: "/pnp/features/connect-external-wallets",
          },
          {
            from: "/connect-external-wallets",
            to: "/pnp/features/connect-external-wallets",
          },
          {
            from: "/developer-dashboard/",
            to: "/dashboard-setup/",
          },
          {
            from: "/developer-dashboard/get-client-id",
            to: "/dashboard-setup/projects-and-analytics",
          },
          {
            from: "/developer-dashboard/enable-interoperability",
            to: "/dashboard-setup/enable-interoperability",
          },
          {
            from: "/developer-dashboard/setup-custom-authentication",
            to: "/dashboard-setup/setup-custom-authentication",
          },
          {
            from: "/developer-dashboard/billing-and-user-stats",
            to: "/dashboard-setup/billing-and-usage",
          },
          {
            from: "/customauth",
            to: "/auth-provider-setup/",
          },
          {
            from: "/customauth/verifiers",
            to: "/auth-provider-setup/verifiers",
          },
          {
            from: "/sdk/web/modal/multi-factor-authentication",
            to: "/sdk/pnp/web/modal/mfa",
          },
          {
            from: "/sdk/web/core/multi-factor-authentication",
            to: "/sdk/pnp/web/no-modal/mfa",
          },
          {
            from: "/sdk/web/web3auth/multi-factor-authentication",
            to: "/sdk/pnp/web/modal/mfa",
          },
          {
            from: "/sdk/helper-sdks/providers/other",
            to: "/sdk/helper-sdks/providers/common",
          },
          {
            from: "/sdk/tkey/initialization",
            to: "/sdk/core-kit/tkey/initialize",
          },
          {
            from: "/sdk/tkey/initialisation",
            to: "/sdk/core-kit/tkey/initialize",
          },
          {
            from: "/troubleshooting/different-wallet-address-issue",
            to: "/troubleshooting/different-private-key",
          },
          {
            from: "/sdk/tkey/installation",
            to: "/sdk/core-kit/tkey/install",
          },
          {
            from: "/content-hub/guides",
            to: "/content-hub",
          },
          {
            from: "/content-hub/guides/mpc",
            to: "/content-hub/guides/mpc-core-kit",
          },
        ],
        createRedirects(existingPath) {
          if (existingPath.includes("/content-hub")) {
            return [
              existingPath.replace("/content-hub/guides", "/guides"),
              existingPath.replace("/content-hub/guides", "/guide"),
              existingPath.replace("/content-hub/blog", "/blogs"),
              existingPath.replace("/content-hub/blog", "/blog"),
              existingPath.replace("/content-hub/guides/auth0", "/customauth/auth0"),
              existingPath.replace("/content-hub/guides/tkey", "/guides/selfhost"),
              existingPath.replace("/content-hub/guides/single-factor-auth", "/guides/one-key-flow"),
            ];
          }
          if (existingPath.includes("/sdk")) {
            return [existingPath.replace("/sdk", "/api-reference"), existingPath.replace("/sdk", "/sdk-reference")];
          }
          if (existingPath.includes("/sdk")) {
            return [
              existingPath.replace("/migration-guide/", "/migration-guides/no-modal-v5-to-v6"),
              existingPath.replace("/migration-guide/migrating-to-v6-from-v5", "/migration-guides/no-modal-v5-to-v6"),
            ];
          }
          if (existingPath.includes("/auth-provider-setup")) {
            return [existingPath.replace("/auth-provider-setup", "/custom-authentication")];
          }
          if (existingPath.includes("/sdk/web/no-modal")) {
            return [existingPath.replace("/sdk/web/no-modal", "/sdk/web/core"), existingPath.replace("/sdk/web/no-modal", "/sdk/web/customloginui")];
          }
          if (existingPath.includes("/sdk/web/modal")) {
            return [existingPath.replace("/sdk/web/modal", "/sdk/web/web3auth"), existingPath.replace("/sdk/web/modal", "/sdk/web/plugnplay")];
          }
          if (existingPath.includes("/sdk/tkey")) {
            return [existingPath.replace("/sdk/tkey", "/sdk/self-host")];
          }
          if (existingPath.includes("/helper-sdks/providers")) {
            return [existingPath.replace("/helper-sdks/providers", "/web/providers")];
          }
          if (existingPath.includes("/helper-sdks/plugins")) {
            return [existingPath.replace("/helper-sdks/plugins", "/web/plugins")];
          }
          if (existingPath.includes("/pnp")) {
            return [
              existingPath.replace("/pnp/web", "/web"),
              existingPath.replace("/pnp/android", "/android"),
              existingPath.replace("/pnp/ios", "/ios"),
              existingPath.replace("/pnp/react-native", "/react-native"),
              existingPath.replace("/pnp/flutter", "/flutter"),
              existingPath.replace("/pnp/unity", "/unity"),
              existingPath.replace("/pnp/unreal", "/unreal"),
            ];
          }
          if (existingPath.includes("/core-kit")) {
            return [
              existingPath.replace("/core-kit/sfa-node", "/node"),
              existingPath.replace("/core-kit/sfa-node", "/core-kit/node"),
              existingPath.replace("/core-kit/sfa-web", "/single-factor-auth"),
              existingPath.replace("/core-kit/sfa-web", "/core-kit/single-factor-auth"),
              existingPath.replace("/core-kit/sfa-android", "/single-factor-auth-android"),
              existingPath.replace("/core-kit/sfa-android", "/core-kit/single-factor-auth-android"),
              existingPath.replace("/core-kit/tkey", "/tkey"),
              existingPath.replace("/core-kit/mpc-core-kit", "/mpc-core-kit"),
              existingPath.replace("/core-kit/introduction", "/self-host/"),
              existingPath.replace("/core-kit/introduction", "/self-hosting"),
            ];
          }
          return undefined; // Return a falsy value: no redirect created
        },
      },
    ],
  ],
  stylesheets: [
    {
      href: "https://cdn.jsdelivr.net/npm/katex@0.13.24/dist/katex.min.css",
      type: "text/css",
      integrity: "sha384-odtC+0UGzzFL/6PNoE8rX/SPcQDXBJ+uRepguP4QkPCm2LBxH3FA3y+fKSiJ+AmM",
      crossorigin: "anonymous",
    },
  ],
  customFields: {
    // 'REACT_HYGRAPHCMS_ENDPOINT': process.env.REACT_HYGRAPHCMS_ENDPOINT,
    REACT_CONTENTFUL_SPACE: process.env.REACT_CONTENTFUL_SPACE,
    REACT_CONTENTFUL_TOKEN: process.env.REACT_CONTENTFUL_TOKEN,
  },
};

async function createConfig() {
  const lightTheme = (await import("./src/components/prismLight.mjs")).default;
  const darkTheme = (await import("./src/components/prismDark.mjs")).default;

  config.themeConfig.prism.theme = lightTheme;
  config.themeConfig.prism.darkTheme = darkTheme;

  return config;
}

module.exports = createConfig;