Stu Mason
Stu Mason

Activity

Pull Request Opened

PR #190 opened: docs: scaffold VitePress site at /site (foundation for coolify-mcp.stumason.dev)

Summary

Stands up a VitePress docs site at /site to publish at coolify-mcp.stumason.dev (dogfood-hosted on the same Coolify the MCP server manages).

Self-contained mini-project — VitePress + mermaid plugin live in /site/package.json, so they don't bloat the npm package or its dep tree. /site is excluded from npm publish via the existing "files": ["dist"] whitelist in the root package.json.

What's in it

SectionPages
LandingHero, features grid, install snippet, capability mindmap, v3 teaser
GuideInstallation (Claude Desktop / Code / Cursor / multi-workspace / Cloudflare-headers), Quickstart
ToolsAll 42 tools grouped by concern, marked read/destructive
ConceptsMCP primer (with control hierarchy + sequence diagram), How coolify-mcp works (architecture + layered responsibilities + token-cost chart + security model), Coolify API gotchas (mirrored from CLAUDE.md)
ContributingAdding tools, Testing tiers, PR flow
RoadmapOverview + v3 vision — Resources / Tasks / Prompts / streamable HTTP, designed as the discussion surface for v3 RFCs
ChangelogIncludes CHANGELOG.md from repo root

Verified locally

  • npm run build clean
  • All mermaid diagrams render (flowcharts, sequence diagrams, mindmap, xychart-beta)
  • Browser preview via Playwright on every key page — no console errors, no broken diagrams
  • Search works (VitePress local provider)

Next

  1. Merge this PR
  2. Provision a Coolify static-site app at coolify-mcp.stumason.dev pointing at this repo
    • Build command: cd site && npm install && npm run build
    • Publish directory: site/.vitepress/dist
  3. Set the DNS CNAME at stumason.dev
  4. Iterate on content in subsequent PRs — auto-deploys on push to main

The v3 vision page is intentionally a working draft — it's the doc we'll plan v3 from.

Test plan

  • npm run build from /site succeeds
  • Browser preview on landing + concepts + roadmap pages, all mermaid diagrams render
  • Search index built
  • Coolify static-site app provisioned, DNS pointed
  • Public URL renders identically to local preview
+5121
additions
-0
deletions
18
files changed