astro.config.mjs

import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
import starlightThemeGalaxy from "starlight-theme-galaxy";
import mermaid from "astro-mermaid";

export default defineConfig({
  // site and base are set via CLI args in CI (from actions/configure-pages)
  integrations: [
    // Must be listed before starlight: astro-mermaid registers remark/rehype
    // plugins that have to see ```mermaid fences before Starlight processes
    // the markdown.
    mermaid({
      // Follows Starlight's light/dark toggle via the data-theme attribute.
      autoTheme: true,
    }),
    starlight({
      title: "Bifrost Proxy",
      description: "A Go-based proxy system with client-server architecture, supporting WireGuard/OpenVPN tunnels, domain-based routing, and multiple authentication modes",
      plugins: [starlightThemeGalaxy()],
      // Without this Starlight emits its default /favicon.svg, which this site
      // does not ship - a 404 on every page.
      favicon: "/logo.svg",
      customCss: ["./src/styles/custom.css"],
      social: [
        { icon: "github", label: "GitHub", href: "https://github.com/rennerdo30/bifrost-proxy" },
      ],
      sidebar: [
        { label: "Home", slug: "index" },
        { label: "Getting Started", slug: "getting-started" },
        {
          label: "Configuration",
          items: [
            { label: "Overview", slug: "configuration" },
            { label: "Backends", slug: "backends" },
            { label: "VPN Providers", slug: "vpn-providers" },
            { label: "Authentication", slug: "authentication" },
            { label: "Advanced Authentication", slug: "configuration/authentication" },
            { label: "VPN Mode", slug: "vpn-mode" },
            { label: "Mesh Networking", slug: "mesh-networking" },
            { label: "HTTP Cache", slug: "cache" },
          ],
        },
        {
          label: "Clients",
          items: [
            { label: "Desktop Client", slug: "desktop-client" },
            { label: "Mobile Client", slug: "mobile-client" },
          ],
        },
        {
          label: "Features",
          items: [
            { label: "Traffic Debugging", slug: "features/traffic-debugging" },
          ],
        },
        { label: "Deployment", slug: "deployment" },
        {
          label: "Usage",
          items: [
            { label: "Client CLI Reference", slug: "usage/cli-reference" },
          ],
        },
        {
          label: "Operations",
          items: [
            { label: "CLI Reference", slug: "cli-reference" },
            { label: "Monitoring", slug: "monitoring" },
            { label: "Security", slug: "security" },
          ],
        },
        {
          label: "Troubleshooting",
          items: [
            { label: "Overview", slug: "troubleshooting" },
            { label: "Connection Issues", slug: "troubleshooting/connections" },
            { label: "Performance", slug: "troubleshooting/performance" },
            { label: "Authentication", slug: "troubleshooting/authentication" },
            { label: "VPN & Tunnels", slug: "troubleshooting/vpn-tunnels" },
            { label: "Diagnostics & Logs", slug: "troubleshooting/diagnostics" },
            { label: "FAQ", slug: "troubleshooting/faq" },
          ],
        },
        {
          label: "API Reference",
          items: [
            { label: "Overview", slug: "api" },
            { label: "Server API", slug: "api/server" },
            { label: "Client API", slug: "api/client" },
            { label: "WebSocket API", slug: "api/websocket" },
            { label: "Authentication", slug: "api/authentication" },
            { label: "Rate Limiting", slug: "api/rate-limiting" },
            { label: "OpenAPI Specification", slug: "api/openapi" },
          ],
        },
        {
          label: "Internals",
          items: [
            { label: "Frame Processing", slug: "internals/frame-processing" },
          ],
        },
        {
          label: "Development",
          items: [
            { label: "Contributing", slug: "contributing" },
            { label: "Changelog", slug: "changelog" },
          ],
        },
      ],
    }),
  ],
});