mcptesta/docs/astro.config.mjs

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

export default defineConfig({
  vite: {
    server: {
      host: '0.0.0.0',
      port: 4321,
      allowedHosts: [
        'localhost',
        process.env.DOMAIN || 'mcptesta.l.supported.systems',
        '.l.supported.systems'
      ]
    }
  },
  integrations: [
    starlight({
      title: 'MCPTesta Documentation',
      description: 'Comprehensive testing framework for FastMCP servers',
      logo: {
        src: './src/assets/mcptesta-logo.svg',
        alt: 'MCPTesta - Lab experiment in progress',
      },
      favicon: '/favicon.svg',
      head: [
        {
          tag: 'link',
          attrs: {
            rel: 'icon',
            type: 'image/x-icon',
            href: '/favicon.ico',
          },
        },
        {
          tag: 'link',
          attrs: {
            rel: 'icon',
            type: 'image/png',
            sizes: '32x32',
            href: '/favicon-32x32.png',
          },
        },
        {
          tag: 'link',
          attrs: {
            rel: 'apple-touch-icon',
            sizes: '180x180',
            href: '/apple-touch-icon.png',
          },
        },
        {
          tag: 'link',
          attrs: {
            rel: 'manifest',
            href: '/site.webmanifest',
          },
        },
        {
          tag: 'meta',
          attrs: {
            name: 'theme-color',
            content: '#8B5CF6',
          },
        },
      ],
      social: {
        github: 'https://git.supported.systems/mcp/mcptesta',
      },
      defaultLocale: 'root',
      locales: {
        root: {
          label: 'English',
          lang: 'en',
        },
      },
      editLink: {
        baseUrl: 'https://git.supported.systems/mcp/mcptesta/_edit/main/docs/',
      },
      lastUpdated: true,
      sidebar: [
        {
          label: 'Getting Started',
          items: [
            { label: 'Introduction', link: '/introduction/' },
            { label: 'Installation', link: '/installation/' },
          ],
        },
        {
          label: 'Tutorials',
          items: [
            { label: 'Your First Test', link: '/tutorials/first-test/' },
            { label: 'Testing Walkthrough', link: '/tutorials/testing-walkthrough/' },
            { label: 'YAML Configuration', link: '/tutorials/yaml-configuration/' },
            { label: 'Parallel Testing', link: '/tutorials/parallel-testing/' },
          ],
        },
        {
          label: 'How-to Guides',
          items: [
            { label: 'CI/CD Integration', link: '/how-to/ci-cd-integration/' },
            { label: 'Container Testing', link: '/how-to/container-testing/' },
            { label: 'Team Collaboration', link: '/how-to/team-collaboration/' },
            { label: 'Security Compliance', link: '/how-to/security-compliance/' },
            { label: 'Test Production Servers', link: '/how-to/test-production-servers/' },
            { label: 'Troubleshooting', link: '/how-to/troubleshooting/' },
          ],
        },
        {
          label: 'Reference',
          items: [
            { label: 'CLI Reference', link: '/reference/cli/' },
            { label: 'YAML Reference', link: '/reference/yaml/' },
            { label: 'API Reference', link: '/reference/api/' },
          ],
        },
        {
          label: 'Explanation',
          items: [
            { label: 'MCP Protocol Testing', link: '/explanation/mcp-protocol/' },
            { label: 'Architecture Overview', link: '/explanation/architecture/' },
            { label: 'Testing Strategies', link: '/explanation/testing-strategies/' },
          ],
        },
        {
          label: 'Community',
          items: [
            { label: 'Contributing', link: '/community/contributing/' },
            { label: 'Changelog', link: '/community/changelog/' },
          ],
        },
      ],
      customCss: [
        './src/styles/custom.css',
      ],
    }),
  ],
});