Starlight

.gitignore

@@ -1,9 +1,13 @@
 # build output
 build
+dist
 
 # ignore docusaurus cache files
 .docusaurus
 
+# ignore astro cache files
+.astro/
+
 # Logs
 logs
 *.log

astro.config.ts

@@ -0,0 +1,102 @@
+import react from '@astrojs/react';
+import starlight from '@astrojs/starlight';
+import { defineConfig } from 'astro/config';
+
+// https://astro.build/config
+export default defineConfig({
+  site: 'https://nebula.defined.net',
+  // Match Docusaurus, we can change this later.
+  outDir: 'build',
+  integrations: [
+    starlight({
+      title: 'Nebula',
+      logo: {
+        alt: 'Nebula Docs',
+        light: './src/assets/mark.svg',
+        dark: './src/assets/mark-dark.svg',
+        replacesTitle: true,
+      },
+      customCss: ['./src/css/base.css', './src/css/theme.css', './src/css/utility.css'],
+      editLink: {
+        baseUrl: 'https://github.com/DefinedNet/nebula-docs/edit/main/',
+      },
+      social: [
+        {
+          icon: 'github',
+          label: 'GitHub',
+          href: 'https://github.com/slackhq/nebula',
+        },
+        {
+          icon: 'slack',
+          label: 'Slack',
+          href: 'https://join.slack.com/t/nebulaoss/shared_invite/zt-39pk4xopc-CUKlGcb5Z39dQ0cK1v7ehA',
+        },
+      ],
+      sidebar: [
+        {
+          label: 'Introduction to Nebula',
+          link: '/',
+        },
+        {
+          label: 'Guides',
+          items: [
+            {
+              label: 'Quick Start',
+              link: '/guides/quick-start',
+            },
+            {
+              label: 'Debugging with Nebula SSH commands',
+              link: '/guides/debug-ssh-commands',
+            },
+            {
+              label: 'Rotating a Certificate Authority',
+              link: '/guides/rotating-certificate-authority',
+            },
+            {
+              label: 'Signing a Certificate Without a Private Key',
+              link: '/guides/sign-certificates-with-public-keys',
+            },
+            {
+              label: 'Extend network access beyond overlay hosts',
+              link: '/guides/unsafe_routes',
+            },
+            {
+              label: 'Upgrading a Nebula network to IPv6 overlay addresses',
+              link: '/guides/upgrade-to-cert-v2-and-ipv6',
+            },
+            {
+              label: 'Using Experimental Lighthouse DNS with Nebula',
+              link: '/guides/using-lighthouse-dns',
+            },
+            {
+              label: 'Viewing Nebula Logs',
+              link: '/guides/viewing-nebula-logs',
+            },
+          ],
+          collapsed: true,
+        },
+        {
+          label: 'Security Bulletins',
+          autogenerate: { directory: 'security' },
+          collapsed: true,
+        },
+        {
+          label: 'Config Reference',
+          autogenerate: { directory: 'config' },
+          collapsed: true,
+        },
+      ],
+    }),
+    react(),
+  ],
+  server: {
+    port: 3000,
+  },
+  vite: {
+    resolve: {
+      alias: {
+        '@theme': '/src/components',
+      },
+    },
+  },
+});

package.json

@@ -5,23 +5,29 @@
   "scripts": {
     "preinstall": "npx only-allow pnpm",
     "postinstall": "pnpm parse-domain-update",
-    "start": "docusaurus start",
-    "build": "pnpm parse-domain-update && docusaurus build",
+    "start": "astro dev",
+    "build": "pnpm parse-domain-update && astro build",
     "preview": "docusaurus serve",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "typecheck": "tsc",
     "test": "uvu -r tsm --dir ."
   },
   "dependencies": {
+    "@astrojs/react": "^4.4.2",
+    "@astrojs/starlight": "^0.37.1",
     "@docusaurus/core": "3.9.2",
     "@docusaurus/preset-classic": "3.9.2",
     "@mdx-js/react": "^3.1.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "astro": "^5.16.5",
     "clsx": "^2.1.1",
     "parse-domain": "^8.2.2",
     "prism-react-renderer": "^2.4.1",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "sharp": "^0.34.5"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "3.9.2",