- OG images: auto-generated per page via astro-og-canvas with maritime
teal theme, wired through Starlight route data middleware
- Mermaid: request flow and parallel fetch diagrams on architecture page
- robots.txt: sitemap and llms.txt references for crawlers
Without ARG/ENV, process.env.DOMAIN was undefined during npm run build,
causing llms.txt internal links to use localhost:4321 instead of the
production domain.
Starlight doesn't emit data-page-template="splash" — it uses
data-has-hero on <html>. All splash-scoped selectors were dead code.
Also remove .card-grid a rules that collided with Starlight's
<CardGrid> component (same class name), causing "See how it works"
links to render as bordered boxes instead of inline text.
Override Starlight's scoped card link styles (display:block, border,
padding) so "See how it works" links render as inline teal text
instead of bordered pill boxes.
- Each use-case card now links to its how-to guide
- Chart showcase below cards: tide chart + conditions dashboard
side by side, with caption linking to visualization guide
- CSS for showcase grid layout and card link styling
- Lead with "One question away" — explains NOAA's station network, the
API gap, and what mcnoaa-tides does, in plain language
- Progressive disclosure: simple explanation → use cases → technical
details → install
- Remove all "AI" references across docs (tagline, getting-started)
- Install section leads with generic MCP JSON config, not product-specific
- New splash landing page at / with hero SVG, feature cards, use-case
scenarios, and quick install section
- Replace Caddyfile redirect with direct index.mdx serving
- Header social icons: git→Gitea source, python→PyPI (was GitHub→PyPI)
- Rewrite fishing-trip, smartpot, and visualization guides as
conversation-style walkthroughs with tool calls behind tabs
- New beach activities guide: snorkeling, tide pooling, beachcombing,
kayak/paddleboard timing
- Make all examples LLM-agnostic (MCP server works with any client)
- Add CSS for splash page layout and conversation blockquote styling
Document tool annotations, structured logging, sampling summaries,
and the new test_client_capabilities diagnostic tool across getting
started, reference, and architecture pages. Fix Vite 6+ host blocking
when serving behind a reverse proxy.
- Clear /usr/share/caddy/* before copying build output to remove
the default "Caddy works!" index.html from the base image
- Add root redirect: / -> /getting-started/ (permanent)
- Fix try_files to use {path}/index.html for Starlight directories
- Switch MCP healthcheck to TCP socket (GET /mcp returns 406
without proper Accept headers)
- 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
