skywalker-1/site/astro.config.mjs

import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import starlightImageZoom from 'starlight-image-zoom';
import starlightLinksValidator from 'starlight-links-validator';

export default defineConfig({
  telemetry: false,
  devToolbar: {
    enabled: false,
  },
  server: {
    host: '0.0.0.0',
    port: 4321,
  },
  vite: {
    server: {
      allowedHosts: [process.env.PUBLIC_DOMAIN, 'localhost'].filter(Boolean),
      ...(process.env.VITE_HMR_HOST && {
        hmr: {
          host: process.env.VITE_HMR_HOST,
          protocol: 'wss',
          clientPort: 443,
        },
      }),
    },
  },
  integrations: [
    starlight({
      title: 'SkyWalker-1 Docs',
      description:
        'Reverse-engineered documentation for the Genpix SkyWalker-1 DVB-S USB 2.0 satellite receiver',
      plugins: [starlightImageZoom(), starlightLinksValidator()],
      social: [
        {
          icon: 'external',
          label: 'Git Repository',
          href: 'https://git.supported.systems/warehack.ing/skywalker-1',
        },
      ],
      customCss: ['./src/styles/custom.css'],
      sidebar: [
        {
          label: 'Hardware',
          items: [
            { label: 'Overview', slug: 'hardware/overview' },
            { label: 'GPIO Pin Map', slug: 'hardware/gpio-pinmap' },
            { label: 'RF Specifications', slug: 'hardware/rf-specifications' },
            { label: 'RF Coverage', slug: 'hardware/rf-coverage' },
          ],
        },
        {
          label: 'USB Interface',
          items: [
            { label: 'Interface', slug: 'usb/interface' },
            { label: 'Vendor Commands', slug: 'usb/vendor-commands' },
            { label: 'Boot Sequence', slug: 'usb/boot-sequence' },
            { label: 'Config Status', slug: 'usb/config-status' },
          ],
        },
        {
          label: 'BCM4500',
          items: [
            { label: 'Register Map', slug: 'bcm4500/register-map' },
            { label: 'Demodulator', slug: 'bcm4500/demodulator' },
            { label: 'Tuning Protocol', slug: 'bcm4500/tuning-protocol' },
            { label: 'GPIF Streaming', slug: 'bcm4500/gpif-streaming' },
            { label: 'Signal Monitoring', slug: 'bcm4500/signal-monitoring' },
          ],
        },
        {
          label: 'LNB & DiSEqC',
          items: [
            { label: 'LNB Control', slug: 'lnb-diseqc/lnb-control' },
            { label: 'DiSEqC Protocol', slug: 'lnb-diseqc/diseqc-protocol' },
            { label: 'Legacy Switch', slug: 'lnb-diseqc/legacy-switch' },
          ],
        },
        {
          label: 'I\u00B2C Bus',
          items: [
            { label: 'Bus Architecture', slug: 'i2c/bus-architecture' },
            {
              label: 'STOP Corruption Bug',
              slug: 'i2c/stop-corruption-bug',
            },
          ],
        },
        {
          label: 'Firmware',
          items: [
            {
              label: 'Version Comparison',
              slug: 'firmware/version-comparison',
            },
            { label: 'Rev.2 Analysis', slug: 'firmware/rev2-analysis' },
            { label: 'Kernel FW01', slug: 'firmware/kernel-fw01' },
            { label: 'FW2.13 Variants', slug: 'firmware/fw213-variants' },
            { label: 'Custom v3.01', slug: 'firmware/custom-v301' },
            { label: 'Custom v3.02', slug: 'firmware/custom-v302' },
            { label: 'Custom v3.05', slug: 'firmware/custom-v305' },
            { label: 'Storage Formats', slug: 'firmware/storage-formats' },
          ],
        },
        {
          label: 'Driver',
          items: [
            { label: 'Linux Kernel', slug: 'driver/linux-kernel' },
            { label: 'DVB-S2', slug: 'driver/dvb-s2' },
          ],
        },
        {
          label: 'Tools',
          items: [
            { label: 'Firmware Loader', slug: 'tools/firmware-loader' },
            { label: 'Tuning', slug: 'tools/tuning' },
            { label: 'SkyWalker RF Tool', slug: 'tools/skywalker' },
            { label: 'SkyWalker TUI', slug: 'tools/tui' },
            { label: 'Motor Control', slug: 'tools/motor' },
            { label: 'Carrier Survey', slug: 'tools/survey' },
            { label: 'EEPROM Utilities', slug: 'tools/eeprom-utilities' },
            { label: 'Debugging', slug: 'tools/debugging' },
            { label: 'TS Analyzer', slug: 'tools/ts-analyzer' },
            { label: 'Spectrum Analysis', slug: 'tools/spectrum-analysis' },
            { label: 'Hydrogen 21 cm', slug: 'tools/h21cm' },
            { label: 'RF Test Bench', slug: 'tools/rf-testbench' },
            { label: 'Beacon Logger', slug: 'tools/beacon-logger' },
            { label: 'Arc Survey', slug: 'tools/arc-survey' },
            { label: 'MCP Server', slug: 'tools/mcp-server' },
            { label: 'Safety Testing', slug: 'tools/safety-testing' },
          ],
        },
        {
          label: 'Guides',
          items: [
            { label: 'Applications & Use Cases', slug: 'guides/applications' },
            { label: 'QO-100 DATV Reception', slug: 'guides/qo100-datv' },
            { label: "Experimenter's Roadmap", slug: 'guides/experimenter-roadmap' },
          ],
        },
        {
          label: 'Reference',
          items: [
            { label: 'Sources', slug: 'reference/master-reference' },
          ],
        },
      ],
    }),
  ],
});