mcaxl/docs/.env.example
Ryan Malloy 314a80d6de docs: deployment scaffolding + logos + live cluster examples
Three additions to the docs site, all atomic to docs/:

1. Deployment configs (Dockerfile + Caddyfile + docker-compose.yml +
   .env.example + Makefile) mirroring bingham/cucx's pattern. The
   compose service uses caddy-docker-proxy labels with the operator's
   .mcp.l.supported.systems wildcard DNS pattern; suggested subdomain
   is mcaxl-docs.mcp.l.supported.systems.

2. Logo + favicon (forest-green palette matching the existing custom.css
   accent). Wordmark uses ui-monospace with currentColor so Starlight
   inverts on light/dark; icon-mark is a terminal chevron + three
   diminishing query-row lines (audit-by-query motif).

3. Live cluster examples in reference/tools.md for axl_version,
   axl_list_tables (route% pattern), and axl_describe_table
   (routepartition). Outputs sanitized per python.md PII rules
   (15.0.1.12900(234) → 15.0(1); cluster-fingerprinting build string
   removed).

Build clean: 17 pages built, pagefind search index across all,
favicon resolves to /favicon.svg, logo fingerprinted into _astro/.

Not yet deployed — operator wires docker compose up when ready.
2026-04-29 04:19:20 -06:00

19 lines
703 B
Plaintext

# mcaxl docs — local environment.
#
# Copy to .env and adjust. `.env` is gitignored.
# Distinguishes this compose project from others on the host.
COMPOSE_PROJECT=mcaxl-docs
# Public hostnames (resolved via the wildcard DNS for *.mcp.l.supported.systems
# that already points at the host's edge caddy-docker-proxy).
# DOMAIN → prod static build
# DEV_DOMAIN → dev server, hot-reload
DOMAIN=mcaxl-docs.mcp.l.supported.systems
DEV_DOMAIN=dev-mcaxl-docs.mcp.l.supported.systems
# Mode switch — drives which compose profile is active.
# dev → astro dev server + HMR (hot reload) at DEV_DOMAIN
# prod → static build served by in-container Caddy at DOMAIN
COMPOSE_PROFILES=dev