← Back

Documentation

Architecture, design and the contributing guide. Every page is generated from the same markdown the repository holds, so the two cannot drift apart.

1.
Architecture

The five-layer stack — UI, API, core engine, grading and storage — and the computerised adaptive diagnostic.

2.
System design

Schema, scheduler, SM-2, grading, the API surface, and the trade-offs behind each.

3.
Administration

Roles, the permission model, staff invitations, the last-owner invariant and the audit trail.

4.
Math input

How a typed answer reaches a verdict: MathLive, MathJSON, the plain-text shim, and the mobile keypad.

5.
Contributing

Add a concept, write a generator, pass the validator.

6.
Efficacy

How Mathua measures learning, and the honest limits of those measurements.

Quickstart (for contributors)

git clone https://github.com/chuma-beep/mathua.git
cd mathua
go build -o bin/mathua ./cmd/mathua

# Run the web server (SQLite by default)
./bin/mathua --serve --port 8080

Requirements: Go 1.26+ · New to Mathua? Start with How it works. Licenses are at Licenses.