Mastery 🏆¶

Checkmate.

Thirty minutes ago you had never seen Heaven. You now know the whole framework — not a useful subset of it, the whole thing.

What you know¶

flowchart LR
    A["<b>3 objects</b><br/>req · res · ctx"] --> B["<b>1 signature</b><br/>(req, res, ctx)"]
    B --> C["<b>2 registrations</b><br/>app.GET · app.schema.GET"]
    C --> D["<b>2 interception points</b><br/>BEFORE · AFTER"]

Everything else is a detail hanging off those four ideas:

Routing is app.METHOD(path, handler), with :params, * wildcards, and typed query strings.
Middleware is a BEFORE or AFTER hook — the same function shape as a handler.
Validation is a TypedDict registered on the sidecar, which also writes your API docs.
State is app.keep() for the process and ctx for the request.
Testing is app.earth, in-process, returning the same three objects.

Where to go next¶

Reference

API Reference — every method, one page Performance — benchmarks, honestly reported Recipes — auth, pagination, real patterns
Operations

Going to Production — headers, CSP, secrets Plugins — extending Heaven Marketplace — community plugins

Before you ship¶

The production checklist is short and each item exists because it bites people. The two that matter most:

Leave debug off, and let your proxy serve static files

Debug mode serves tracebacks to clients, so keep it to development. app.ASSETS() is safe to leave mounted, but a proxy or CDN will serve those files faster. Both are covered in Security and Templates & Assets.

Contributing¶

Heaven is small enough to read in an afternoon — roughly 2,400 lines across fifteen modules. That is by design, and it means a first contribution is genuinely approachable.

Star the repo, file an issue, or open a PR →

"Simplicity is the ultimate sophistication." — Leonardo da Vinci

May your response times be low and your uptime high. ⚡