docusaurus.config.js

// @ts-check
const { themes: prismThemes } = require('prism-react-renderer');

/** @type {import('@docusaurus/types').Config} */
const config = {
  title: 'Zooza Developer Docs',
  tagline: 'API and widget integration guides for the Zooza platform',
  favicon: 'img/favicon.ico',
  url: 'https://docs.zooza.online',
  baseUrl: '/',

  organizationName: 'zooza',
  projectName: 'api-docs',

  onBrokenLinks: 'throw',
  markdown: {
    mermaid: true,
    hooks: {
      onBrokenMarkdownLinks: 'warn',
    },
  },

  // Defensive gtag stub — prevents `window.gtag is not a function` when
  // googletagmanager.com is blocked (ad-blockers, tracking-protection) or
  // when the plugin's own bootstrap hasn't run (dev server, stale bundles).
  // Idempotent with @docusaurus/plugin-google-gtag's own snippet.
  headTags: [
    {
      tagName: 'script',
      attributes: {},
      innerHTML:
        "window.dataLayer = window.dataLayer || [];" +
        "if (typeof window.gtag !== 'function') {" +
        "  window.gtag = function () { window.dataLayer.push(arguments); };" +
        "}",
    },
  ],

  i18n: {
    defaultLocale: 'en',
    locales: ['en'],
  },

  presets: [
    [
      'classic',
      /** @type {import('@docusaurus/preset-classic').Options} */
      ({
        docs: {
          sidebarPath: require.resolve('./sidebars.js'),
          routeBasePath: '/',
          editUrl: undefined,
          docItemComponent: '@theme/ApiItem',
        },
        blog: false,
        theme: {
          customCss: require.resolve('./src/css/custom.css'),
        },
        gtag: {
          trackingID: 'G-96E3E87NS0',
          anonymizeIP: true,
        },
        sitemap: {
          changefreq: 'weekly',
          priority: 0.7,
          ignorePatterns: ['/tags/**'],
          filename: 'sitemap.xml',
        },
      }),
    ],
  ],

  plugins: [
    [
      'docusaurus-plugin-openapi-docs',
      {
        id: 'zoozaApi',
        docsPluginId: 'classic',
        config: {
          zoozaApi: {
            specPath: 'static/zooza_api_v1.yaml',
            outputDir: 'docs/api/reference',
            sidebarOptions: {
              groupPathsBy: 'tag',
              categoryLinkSource: 'tag',
            },
          },
        },
      },
    ],
    [
      '@docusaurus/plugin-client-redirects',
      {
        redirects: [
          { from: '/api/endpoints', to: '/api/reference' },
        ],
      },
    ],
  ],

  themes: ['docusaurus-theme-openapi-docs', '@docusaurus/theme-mermaid'],

  themeConfig:
    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
    ({
      image: 'img/social-card.png',

      navbar: {
        title: 'Zooza Docs',
        logo: {
          alt: 'Zooza',
          src: 'img/logo.svg',
          srcDark: 'img/logo-dark.svg',
        },
        items: [
          { to: '/quickstart', label: 'Quickstart', position: 'left' },
          { to: '/widgets', label: 'Widgets', position: 'left' },
          { to: '/api', label: 'API', position: 'left' },
          {
            href: 'https://zooza.app',
            label: 'Go to app',
            position: 'right',
          },
        ],
      },

      footer: {
        style: 'dark',
        links: [
          {
            title: 'Documentation',
            items: [
              { label: 'Quickstart', to: '/quickstart' },
              { label: 'Concepts', to: '/concepts' },
              { label: 'Widgets', to: '/widgets' },
              { label: 'API Reference', to: '/api' },
              { label: 'Enums', to: '/enums' },
            ],
          },
          {
            title: 'More',
            items: [
              { label: 'Zooza App', href: 'https://zooza.app' },
              { label: 'Zooza Website', href: 'https://zooza.online' },
              { label: 'Support', href: 'mailto:support@zooza.online' },
            ],
          },
        ],
        copyright: `Copyright © ${new Date().getFullYear()} Zooza. All rights reserved.`,
      },

      prism: {
        theme: prismThemes.github,
        darkTheme: prismThemes.dracula,
        additionalLanguages: ['bash', 'php', 'json'],
      },

      algolia: {
        appId: 'G4L1X5YJDL',
        apiKey: '664f30b167ab43a3fe92115ab39c90b6',
        indexName: 'Zooza API Docs',
        contextualSearch: true,
        searchPagePath: 'search',
      },

      colorMode: {
        defaultMode: 'light',
        disableSwitch: false,
        respectPrefersColorScheme: true,
      },
    }),
};

module.exports = config;