docs: rework documentation site (#1589)

* initial commit * inital changes * commit WIP Information Architecture * commit a working state * add static assets and project * add org and fix img names * add plausible * remove img * change sidebar to easier mgmt * add openid oauth and domains * lint md * quickstarts * add auth flow * identity brokering * remove site * fix broken links * extend footer * extend readme * fix: styling * fix: zitadel logo on index * styling * border * fix: nav * fix: nav * fix: index * fix: rename architecture to concepts * fix: introductions * fix: introductions * fix: introductions * fix: get started * fix: user manual * fix: zitadel architecture * fix: dead links * add favicon Co-authored-by: fabi <fabienne.gerschwiler@gmail.com> Co-authored-by: Livio Amstutz <livio.a@gmail.com>
2025-08-11 20:17:32 +00:00 · 2021-04-15 13:22:37 +02:00
parent c7e7ef8e74
commit dfc9488bb5
248 changed files with 41653 additions and 17764 deletions
--- a/docs/docusaurus.config.js
+++ b/docs/docusaurus.config.js
@@ -0,0 +1,136 @@
+/** @type {import('@docusaurus/types').DocusaurusConfig} */
+module.exports = {
+  title: 'ZITADEL Docs',
+  url: 'https://docs.zitadel.ch',
+  baseUrl: '/',
+  onBrokenLinks: 'throw',
+  onBrokenMarkdownLinks: 'warn',
+  favicon: 'img/favicon.ico',
+  organizationName: 'caos',
+  projectName: 'zitadel',
+  themeConfig: {
+    navbar: {
+      title: 'ZITADEL',
+      logo: {
+        alt: 'ZITADEL logo',
+        src: 'img/zitadel-logo-solo-darkdesign.svg',
+      },
+      items: [
+        {
+          type: 'doc',
+          docId: 'manuals/introduction',
+          label: 'Manuals',
+          position: 'left'
+        },
+        {
+          type: 'doc',
+          label: 'Quickstarts',
+          docId: 'quickstarts/introduction',
+          position: 'left'
+        },
+        {
+          type: 'doc',
+          label: 'Guides',
+          docId: 'guides/introduction',
+          position: 'left'
+        },
+        {
+          type: 'doc',
+          label: 'APIs',
+          docId: 'apis/introduction',
+          position: 'left'
+        },
+        {
+          type: 'doc',
+          docId: 'concepts/introduction',
+          label: 'Concepts',
+          position: 'left'
+        },
+        {
+          href: 'https://github.com/caos/zitadel',
+          label: 'GitHub',
+          position: 'right',
+        },
+      ],
+    },
+    footer: {
+      style: 'dark',
+      links: [
+        {
+          title: 'Community',
+          items: [
+            {
+              label: 'GitHub Discussions',
+              href: 'https://github.com/caos/zitadel/discussions',
+            },
+            {
+              label: 'Twitter',
+              href: 'https://twitter.com/zitadel_ch',
+            },
+            {
+              label: 'Linkedin',
+              href: 'https://www.linkedin.com/company/caos-ag/',
+            },
+            {
+              label: 'Blog',
+              href: 'https://zitadel.ch/blog',
+            },
+          ],
+        },
+        {
+          title: 'Company',
+          items: [
+            {
+              label: 'About CAOS Ltd.',
+              href: 'https://caos.ch/#about',
+            },
+            {
+              label: 'Contact',
+              href: 'https://zitadel.ch/contact/',
+            },
+            {
+              label: 'GitHub',
+              href: 'https://github.com/caos',
+            },
+            {
+              label: 'Status',
+              href: 'https://status.zitadel.ch/',
+            },
+            {
+              label: 'Terms and Conditions',
+              href: 'https://zitadel.ch/pdf/tos.pdf',
+            },
+            {
+              label: 'Privacy Policy',
+              href: 'https://zitadel.ch/pdf/privacy.pdf',
+            },
+          ],
+        },
+      ],
+      copyright: `Copyright © ${new Date().getFullYear()} CAOS Ltd. Built with Docusaurus.`,
+    },
+  },
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          sidebarPath: require.resolve('./sidebars.js'),
+          editUrl:
+            'https://github.com/caos/zitadel/edit/main/docs/',
+        },
+        theme: {
+          customCss: require.resolve('./src/css/custom.css'),
+        },
+      },
+    ],
+  ],
+  plugins: [
+    [
+      'docusaurus-plugin-plausible',
+      {
+        domain: 'docs.zitadel.ch',
+      },
+    ]
+  ],
+};