mcnoaa-tides/docs/astro.config.mjs
Ryan Malloy a02d660764 Add Starlight docs site and MCP HTTP transport
- Starlight documentation with 12 Diátaxis-organized pages covering
  getting started, how-to guides, reference, and architecture
- Docker Compose with two services: docs (Starlight/Caddy) and
  mcp (FastMCP streamable-http), both behind caddy-docker-proxy
- Env-based transport selection in server.py — stdio default preserved,
  MCP_TRANSPORT=streamable-http activates HTTP mode for Docker
- Ocean/maritime theme with dark mode default
2026-02-22 19:05:12 -07:00

62 lines
1.5 KiB
JavaScript

import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
const domain = process.env.DOMAIN || "localhost:4321";
const protocol = domain.startsWith("localhost") ? "http" : "https";
export default defineConfig({
site: `${protocol}://${domain}`,
telemetry: false,
devToolbar: { enabled: false },
integrations: [
starlight({
title: "mcnoaa-tides",
description:
"FastMCP server for NOAA CO-OPS tide predictions, water levels, and marine conditions.",
customCss: [
"@fontsource/inter/400.css",
"@fontsource/inter/600.css",
"@fontsource/jetbrains-mono/400.css",
"./src/styles/custom.css",
],
social: [
{
icon: "github",
label: "PyPI",
href: "https://pypi.org/project/mcnoaa-tides/",
},
],
sidebar: [
{
label: "Getting Started",
autogenerate: { directory: "getting-started" },
},
{
label: "How-To Guides",
autogenerate: { directory: "how-to" },
},
{
label: "Reference",
autogenerate: { directory: "reference" },
},
{
label: "Understanding",
autogenerate: { directory: "understanding" },
},
],
}),
],
vite: {
server: {
host: "0.0.0.0",
...(process.env.VITE_HMR_HOST && {
hmr: {
host: process.env.VITE_HMR_HOST,
protocol: "wss",
clientPort: 443,
},
}),
},
},
});