Per-institution subdomains
Giving each institution its own front door, with isolated data and its own branding.
What a subdomain gives you
- No institution picker — the host identifies the tenant, so users land on a branded sign-in.
- Branding, sign-in and email links all follow the subdomain.
- Fully isolated data. Isolation is enforced at the data layer regardless of host; the subdomain is the visible half of it.
Claiming one
- 1An admin claims it during institution setup
The subdomain is recorded against the institution.
- 2DNS resolves it
Tenant records are codified in Terraform alongside the wildcard certificate.
- 3It resolves to the same application
There is no per-tenant deployment. One application, resolving its tenant from the host.
How the application behaves
On a tenant subdomain the institution arrives asynchronously as the host is resolved. The application holds the redirect until that lookup settles rather than bouncing the user to the picker and back — a detail that matters because the alternative is a visible flicker on every cold load.