High-level production topology for HaloRT. Canonical infra write-up: halort-infra/docs/architecture.md and STACK.md.
Edge to apps
Internet → Cloudflare (DNS, edge TLS, apex → www)
→ Hetzner ingress LB
→ ingress-nginx + cert-manager
→ www / app / api / design / docs / notifications / {slug}.halort.com
→ MariaDB / PostgreSQL / Redis (in-cluster)
| Host | Service | Repo |
|---|---|---|
www.halort.com | Marketing | halort-web |
app.halort.com | SaaS frontend | halort-platform-web |
api.halort.com | API | halort-platform |
design.halort.com | Storybook | halort-design-system |
docs.halort.com | Knowledge base | halort-docs |
notifications.halort.com | Email API | halort-notification-service |
{slug}.halort.com | Tenant public sites | platform-web wildcard |
Core ideas
- Multi-tenant: one community per tenant, data scoped by
tenant_id— see Multi-tenancy. - Browser SaaS traffic: Next.js → Eden Treaty → Elysia → Prisma → MariaDB.
- Shared UI/email tokens from the design system.
- Mobile apps talk to the same API — Surfaces/Mobile iOS · Surfaces/Mobile Android.