nanovna-f-v3-docs/astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

export default defineConfig({
  site: 'https://nanovna-f.l.zmesh.systems',
  telemetry: false,
  devToolbar: { enabled: false },
  integrations: [
    starlight({
      title: 'NanoVNA-F V3 Documentation',
      tagline: 'Portable vector network analyzer — 1 MHz to 6 GHz',
      logo: {
        alt: 'NanoVNA-F V3',
        src: './src/assets/logo.svg',
      },
      customCss: ['./src/styles/custom.css', './src/styles/landing.css'],
      head: [
        {
          tag: 'meta',
          attrs: {
            name: 'theme-color',
            content: '#2d7d9a',
          },
        },
      ],
      sidebar: [
        {
          label: 'Getting Started',
          items: [
            { label: 'What is NanoVNA-F V3?', slug: 'getting-started/overview' },
            { label: 'Quick Start Guide', slug: 'getting-started/quick-start' },
            { label: 'Hardware Overview', slug: 'getting-started/hardware' },
            { label: 'VNA Basics', slug: 'getting-started/vna-basics' },
          ],
        },
        {
          label: 'Tutorials',
          items: [
            {
              label: 'First Measurements',
              collapsed: true,
              items: [
                { label: 'Your First S11 Measurement', slug: 'tutorials/first-measurements/first-s11' },
                { label: 'Your First S21 Measurement', slug: 'tutorials/first-measurements/first-s21' },
                { label: 'Reading the Display', slug: 'tutorials/first-measurements/reading-display' },
              ],
            },
            {
              label: 'Calibration',
              collapsed: true,
              items: [
                { label: 'Full Calibration', slug: 'tutorials/calibration/full-calibration' },
                { label: 'Saving Calibrations', slug: 'tutorials/calibration/saving-calibration' },
                { label: 'Port Extension', slug: 'tutorials/calibration/port-extension' },
              ],
            },
            {
              label: 'Practical Projects',
              collapsed: true,
              items: [
                { label: 'Testing an Antenna', slug: 'tutorials/practical-projects/testing-antenna' },
                { label: 'Measuring a Filter', slug: 'tutorials/practical-projects/measuring-filter' },
                { label: 'Cable Length with TDR', slug: 'tutorials/practical-projects/cable-tdr' },
              ],
            },
          ],
        },
        {
          label: 'How-To Guides',
          items: [
            {
              label: 'Display & Traces',
              collapsed: true,
              items: [
                { label: 'Configure Traces', slug: 'how-to/display-traces/configure-traces' },
                { label: 'Display Formats', slug: 'how-to/display-traces/display-formats' },
                { label: 'Scale & Reference', slug: 'how-to/display-traces/scale-reference' },
                { label: 'Dark Mode', slug: 'how-to/display-traces/dark-mode' },
              ],
            },
            {
              label: 'Markers',
              collapsed: true,
              items: [
                { label: 'Using Markers', slug: 'how-to/markers/using-markers' },
                { label: 'Marker Search', slug: 'how-to/markers/marker-search' },
                { label: 'Marker Operations', slug: 'how-to/markers/marker-operations' },
              ],
            },
            {
              label: 'Measurement Tools',
              collapsed: true,
              items: [
                { label: 'Signal Generator', slug: 'how-to/measurement-tools/signal-generator' },
                { label: 'CW Pulse Mode', slug: 'how-to/measurement-tools/cw-pulse' },
                { label: 'TDR Mode', slug: 'how-to/measurement-tools/tdr-mode' },
                { label: 'S-Parameter Export', slug: 'how-to/measurement-tools/s-parameter-export' },
              ],
            },
            {
              label: 'Configuration',
              collapsed: true,
              items: [
                { label: 'Language & Brightness', slug: 'how-to/configuration/language-brightness' },
                { label: 'Date/Time & Average', slug: 'how-to/configuration/datetime-average' },
                { label: 'User Defined Info', slug: 'how-to/configuration/user-defined-info' },
                { label: 'Firmware Update', slug: 'how-to/configuration/firmware-update' },
              ],
            },
            {
              label: 'PC Software',
              collapsed: true,
              items: [
                { label: 'USB Connection', slug: 'how-to/pc-software/usb-connection' },
                { label: 'Console Commands', slug: 'how-to/pc-software/console-commands' },
              ],
            },
          ],
        },
        {
          label: 'Reference',
          collapsed: true,
          items: [
            {
              label: 'User Interface',
              collapsed: true,
              items: [
                { label: 'Menu Map', slug: 'reference/user-interface/menu-map' },
                { label: 'Main Screen Regions', slug: 'reference/user-interface/screen-regions' },
                { label: 'Virtual Keyboard', slug: 'reference/user-interface/keyboard' },
              ],
            },
            { label: 'Specifications', slug: 'reference/specifications' },
            { label: 'Console Command Reference', slug: 'reference/command-reference' },
            { label: 'Calibration Status Codes', slug: 'reference/calibration-codes' },
            { label: 'Charging & LED Indicators', slug: 'reference/charging-leds' },
          ],
        },
      ],
    }),
  ],
});