MUTX Docs

This is the contributor-facing documentation hub for MUTX.

Use this directory when you want the code-accurate view of how the platform is structured, how to run it, and where the current gaps are.

Start Here

• Manifesto - product thesis, principles, and why MUTX exists

• Technical Whitepaper - deeper technical framing and architecture narrative

• Top-level README - project overview and entry points

• Project Status - what is real, what is rough, and where contributors can help next

• Roadmap - priority sequencing for the next layer of work

Quick Links

Core Platform

• Architecture Overview - system layout and target direction

• API Overview - route groups, auth shape, and request conventions

• CLI Guide - terminal workflows and command behavior

• Deployment Quickstart - local bootstrap and hosted setup

Infrastructure And Ops

• Infrastructure Overview - provisioning and hosting model

• Docker Deployment - containerized workflows

• Railway Deployment - hosted deployment notes

• Security Architecture - boundaries, auth, and ops posture

Troubleshooting

• Common Issues

• Debugging Guide

• FAQ

Reality Check

The most important rule in this repo is simple:

• trust src/api/routes/ for API behavior

• trust cli/ for CLI behavior

• trust sdk/mutx/ for SDK behavior

• trust app/ and app/api/ for website and app-surface behavior

If a doc and the code disagree, the code wins and the doc should be updated.