Architecture, deployment,
and runtime maps for the whole platform.
Generated graph views, deployment references, operating guides, and auth runtime notes — packaged into one deployable docs experience.
Deployment reference patterns
Open the model that matches the hosting shape you actually care about, then use the generated flows for communication order and rollout order.
Single-server Coolify
Best when one host can still comfortably own the proxy, services, jobs, and database without becoming a space heater with feelings.
Hosted Ubuntu + Coolify
Build once on a dedicated Coolify build server, publish immutable images to the registry, then let the runtime host pull and roll forward.
Multi-node Scale-out
External load balancer terminates SSL and round-robins to identical servers. Every server runs the same domains and apps behind its own Traefik proxy.
Generated system views
These are the fast-path diagrams you will actually reopen when someone asks “how does this thing talk to that thing?” five minutes before a deployment.
Service Topology
The runtime map of frontends, APIs, backing services, ports, and persistent volumes across the monorepo.
Communication Map
HTTP and WebSocket relationships between frontends, Better Auth, APIs, and the supporting services.
Auth Flow
Source-driven Better Auth modules, middleware, and the end-to-end auth request path generated from the auth app.
Forms-Service Auth Flow
Shows how a Better Auth JWT moves from the browser into records-service middleware and then into SurrealDB authenticate(token).
Deployment Order
The rollout sequencing view that helps explain how migrations, runtimes, and frontends come up without stepping on each other.
Hosted Deployment Flow
A flow-first view of Forgejo, Coolify, the build server, the registry, and the runtime host working in sequence.
Multi-node Deployment Flow
Build-once-deploy-everywhere flow with load balancer round-robin and per-server Traefik routing.
Build the latest docs, package the app, ship one container.
Regenerate architecture artefacts, build the frontend shell, and publish the current repo state as a proper site — one command, one image, one deploy.