mcesptool/docs-site/astro.config.mjs
Ryan Malloy b2ba0cd67a Upgrade to FastMCP 3.x, add Starlight docs site
Dependency changes:
- fastmcp >=2.12.4 → >=3.0.2,<4
- Drop asyncio-mqtt (dead dependency, never imported)
- Align pydantic, click, rich with FastMCP 3.x
- Bump version to 2026.02.23

Docs site (docs-site/):
- Astro Starlight with Tailwind v4 teal theme
- 28 pages following Diataxis: 3 tutorials, 7 how-to guides,
  13 reference pages, 4 explanation pages
- Docker infrastructure (Caddy prod, Node HMR dev)
- Configured for mcesptool.warehack.ing
2026-02-23 18:57:16 -07:00

113 lines
3.2 KiB
JavaScript

import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";
import tailwindcss from "@tailwindcss/vite";
import sitemap from "@astrojs/sitemap";
export default defineConfig({
site: "https://mcesptool.warehack.ing",
telemetry: false,
devToolbar: { enabled: false },
integrations: [
starlight({
title: "mcesptool",
description:
"ESP32 and ESP8266 development through Model Context Protocol",
favicon: "/favicon.svg",
social: [
{
icon: "github",
label: "Source",
href: "https://git.supported.systems/MCP/mcesptool",
},
],
customCss: ["./src/styles/global.css"],
sidebar: [
{
label: "Tutorials",
items: [
{ label: "Getting Started", slug: "tutorials/getting-started" },
{ label: "First Flash", slug: "tutorials/first-flash" },
{
label: "First QEMU Session",
slug: "tutorials/first-qemu-session",
},
],
},
{
label: "How-To Guides",
autogenerate: { directory: "guides" },
},
{
label: "Reference",
items: [
{ label: "Overview", slug: "reference" },
{
label: "Tool Reference",
collapsed: true,
items: [
{
label: "Chip Control",
slug: "reference/chip-control",
},
{
label: "Flash Operations",
slug: "reference/flash-operations",
},
{
label: "Partition Management",
slug: "reference/partition-management",
},
{ label: "Security", slug: "reference/security" },
{
label: "Firmware Builder",
slug: "reference/firmware-builder",
},
{
label: "OTA Management",
slug: "reference/ota-management",
},
{
label: "Production Tools",
slug: "reference/production-tools",
},
{
label: "Diagnostics",
slug: "reference/diagnostics",
},
{
label: "QEMU Manager",
slug: "reference/qemu-manager",
},
{
label: "Server Tools",
slug: "reference/server-tools",
},
],
},
{ label: "Resources", slug: "reference/resources" },
{ label: "Configuration", slug: "reference/configuration" },
],
},
{
label: "Explanation",
autogenerate: { directory: "explanation" },
},
],
}),
sitemap(),
],
vite: {
plugins: [tailwindcss()],
server: {
host: "0.0.0.0",
...(process.env.VITE_HMR_HOST && {
hmr: {
host: process.env.VITE_HMR_HOST,
protocol: "wss",
clientPort: 443,
},
}),
},
},
});