Magma Devs Documentation

Documentation site for Smart Router — the centralised RPC routing gateway with QoS-based selection, caching, and failover policies.

Built with MkDocs Material. All content lives under docs/; the site is configured in mkdocs.yml.

Preview locally

pip install -r requirements.txt
mkdocs serve            # http://127.0.0.1:8000

Build

mkdocs build --strict   # output in site/ (gitignored); --strict fails on broken links

Deployment

Pushing to main triggers .github/workflows/docs.yml, which builds the site and publishes it to GitHub Pages at https://magma-devs.github.io/docs/.

One-time setup: in the repo's Settings → Pages → Build and deployment, set Source to "GitHub Actions" for the deploy job to publish.