StuMason/coolify-mcp
TypeScript
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
| Section | Pages |
|---|---|
| Landing | Hero, features grid, install snippet, capability mindmap, v3 teaser |
| Guide | Installation (Claude Desktop / Code / Cursor / multi-workspace / Cloudflare-headers), Quickstart |
| Tools | All 42 tools grouped by concern, marked read/destructive |
| Concepts | MCP 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) |
| Contributing | Adding tools, Testing tiers, PR flow |
| Roadmap | Overview + v3 vision — Resources / Tasks / Prompts / streamable HTTP, designed as the discussion surface for v3 RFCs |
| Changelog | Includes CHANGELOG.md from repo root |
Verified locally
npm run buildclean- 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
- Merge this PR
- Provision a Coolify static-site app at
coolify-mcp.stumason.devpointing at this repo- Build command:
cd site && npm install && npm run build - Publish directory:
site/.vitepress/dist
- Build command:
- Set the DNS CNAME at stumason.dev
- 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 buildfrom/sitesucceeds - 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