Skip to content

docs: add user guide with screenshots - #131

Merged
its-mash merged 2 commits into
mainfrom
docs/add-user-guide
Feb 20, 2026
Merged

docs: add user guide with screenshots#131
its-mash merged 2 commits into
mainfrom
docs/add-user-guide

Conversation

@its-mash

Copy link
Copy Markdown
Member

Summary

  • Adds 9 comprehensive MDX documentation pages covering all McpMux concepts: Spaces, FeatureSets, Clients, Servers, Gateway, Security, Getting Started, Server Definitions schema, and overview
  • Embeds 12 screenshots with absolute URLs (https://mcpmux.com/screenshots/) so they render on both GitHub and the website
  • Includes sidebar ordering via meta.json with Getting Started / Core Concepts / Advanced sections
  • Adds GitHub Action (docs-deploy.yml) to trigger Cloudflare Pages rebuild when docs/guide/** changes on main

How it works

The MDX source files live here in the public mcp-mux repo. At build time, mcpmux.discover.ui runs fetch-docs.mjs which copies these files into its content/docs/ directory. Fumadocs renders them at mcpmux.com/docs/.

Companion PR

New files

  • docs/guide/*.mdx — 9 documentation pages + meta.json sidebar config
  • .github/workflows/docs-deploy.yml — auto-triggers website rebuild on docs changes

Test plan

  • pnpm build passes in mcpmux.discover.ui with all 55 static pages generated
  • All 9 docs pages return 200 in dev server
  • Screenshots use absolute URLs — render on GitHub and website
  • Verify production deploy renders docs at mcpmux.com/docs/

Adds comprehensive documentation covering McpMux concepts (Spaces,
FeatureSets, Clients, Gateway, Security), getting started guide,
server management, and server definition schema reference.

Content is sourced by mcpmux.discover.ui at build time via
fetch-docs.mjs and rendered with Fumadocs on mcpmux.com/docs.

Includes GitHub Action to trigger Cloudflare Pages rebuild when
docs change on main.

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
@its-mash
its-mash force-pushed the docs/add-user-guide branch from 4a33529 to 0ebcab5 Compare February 20, 2026 08:57
@its-mash
its-mash merged commit ee28e8b into main Feb 20, 2026
3 checks passed
@its-mash
its-mash deleted the docs/add-user-guide branch February 20, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant