flipper/website/docusaurus.config.js

/**
 * Copyright (c) Facebook, Inc. and its affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * @format
 */

// start-import-example
const {fbContent, fbInternalOnly} = require('internaldocs-fb-helpers');
// end-import-example

const repoUrl = 'https://github.com/facebook/flipper';
const siteConfig = {
  title: fbContent({
    internal: 'Flipper @FB',
    external: 'Flipper',
  }),
  tagline: 'Extensible mobile app debugging',
  url: fbContent({
    internal: 'https://flipper.thefacebook.com/',
    external: 'https://fbflipper.com/',
  }),
  baseUrl: '/',
  projectName: 'flipper',
  // TODO: T69061026 enable once sandy docs are complete: external_domain: 'fbflipper.com',
  themeConfig: {
    navbar: {
      title: fbContent({
        internal: 'Flipper @FB',
        external: 'Flipper',
      }),
      logo: {
        alt: 'Flipper Logo',
        src: 'img/icon.png',
      },
      items: [
        {
          to: 'docs/features/index',
          label: 'Features',
          position: 'right',
        },
        {
          to: 'docs/getting-started/index',
          label: 'Setup',
          position: 'right',
        },
        {
          to: 'docs/tutorial/intro',
          label: 'Creating Plugins',
          position: 'right',
        },
        {
          to: 'docs/internals/index',
          label: 'Under the Hood',
          position: 'right',
        },
        {
          href: repoUrl,
          position: 'right',
          'aria-label': 'GitHub repository',
          className: 'navbar-github-link',
        },
      ],
    },
    colorMode: {
      // Nothing against dark mode, but our current CSS doesn't have high contrast
      // so it needs some work before being enabled.
      defaultMode: 'light',
      disableSwitch: true,
    },
    footer: {
      style: 'dark',
      links: [
        {
          title: 'Learn',
          items: [
            {
              label: 'Getting Started',
              to: 'docs/getting-started/index',
            },
            {
              label: 'Plugin Creation Tutorial',
              to: 'docs/tutorial/intro',
            },
          ],
        },
        {
          title: 'Plugins',
          items: [
            {
              label: 'Core Plugins',
              to: 'docs/features/index',
            },
            {
              label: 'Community Plugins',
              href: 'https://www.npmjs.com/search?q=keywords:flipper-plugin',
            },
          ],
        },
        {
          title: 'Legal',
          // Please do not remove the privacy and terms, it's a legal requirement.
          items: [
            {
              label: 'Privacy',
              href: 'https://opensource.facebook.com/legal/privacy/',
            },
            {
              label: 'Terms',
              href: 'https://opensource.facebook.com/legal/terms/',
            },
          ],
        },
        {
          title: 'More',
          items: [
            {
              label: 'Twitter',
              href: 'https://twitter.com/flipper_fb',
            },
            {
              label: 'GitHub',
              href: repoUrl,
            },
          ],
        },
      ],
      copyright: 'Copyright © ' + new Date().getFullYear() + ' Facebook',
      logo: {
        alt: 'Flipper Mascot',
        src: 'img/mascot.png',
      },
    },
    algolia: fbContent({
      internal: undefined,
      external: {
        apiKey: '2df980e7ffc95c19552790f7cad32666',
        indexName: 'fbflipper',
        algoliaOptions: {
          hitsPerPage: 5,
        },
      },
    }),
    prism: {
      additionalLanguages: ['groovy', 'java', 'kotlin', 'ruby', 'swift', 'objectivec'],
    },
  },
  favicon: 'img/icon.png',
  scripts: [
    'https://buttons.github.io/buttons.js',
    'https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js',
    '/js/code-blocks-buttons.js',
    '/js/google-analytics.js',
  ],
  stylesheets: [],
  // start_config_example
  presets: [
    [
      require.resolve('docusaurus-plugin-internaldocs-fb/docusaurus-preset'),
      {
        docs: {
          path: '../docs',
          sidebarPath: require.resolve('./sidebars.js'),
          editUrl: 'https://github.com/facebook/flipper/blob/master/website',
        },
        theme: {
          customCss: require.resolve('./static/css/custom.css'),
        },
      },
    ],
  ],
  // end_config_example
  plugins: [
    [
      '@docusaurus/plugin-client-redirects',
      {
        redirects: [
          {
            to: '/docs/troubleshooting',
            from: ['/docs/fb/troubleshooting'],
          },
          {
            to: '/docs/tutorial/intro',
            from: ['/docs/extending'],
          },
          {
            to: '/docs/extending/desktop-plugin-structure',
            from: ['/docs/extending/js-setup'],
          },
          {
            to: '/docs/extending/create-plugin',
            from: [
              '/docs/extending/send-data',
              '/docs/fb/android-plugin-development-Android-interacting-0',
            ],
          },
          {
            to: '/docs/tutorial/intro',
            from: ['/docs/fb/create-new-plugin'],
          },
          {
            to: '/docs/extending/dev-setup',
            from: ['/docs/fb/developmentworkflow'],
          },
          {
            to: '/docs/getting-started/index',
            from: ['/docs/fb/Help-Updating-Flipper'],
          },
          {
            to: '/docs/extending/create-plugin',
            from: [
              '/docs/fb/ios-plugin-development-sending-data-to-an-ios-plugin-0',
            ],
          },
          {
            to: '/docs/extending/dev-setup',
            from: ['/docs/fb/TypeScript'],
          },
          {
            to: '/docs/extending/flipper-plugin',
            from: ['/docs/fb/using-gatekeepers'],
          },
          {
            to: '/docs/getting-started/index',
            from: ['/docs/fb/using-flipper-at-facebook'],
          },
          {
            to: '/docs/getting-started/index',
            from: ['/docs/fb/index'],
          },
        ],
      },
    ],
  ],
};

module.exports = siteConfig;