Overview
What Ouranos is and how this documentation is organized
Ouranos is a reusable SaaS template: an AWS serverless foundation (Terraform, Aurora DSQL, SES, Route 53, CloudFront with Lambda via OpenNext), a Next.js monorepo (landing, app, docs), Better Auth with organizations and optional Stripe payments, and GitHub Actions CI/CD via OIDC — provisioned end to end. The template repository is also a live instance of itself.
The three apps
| App | Hostname | What it serves |
|---|---|---|
| Landing | Z (the instance zone apex) | Static marketing site and legal pages |
| App | app.Z | The authenticated product, on Lambda via OpenNext |
| Docs | docs.Z | This site — static export with in-browser search |
What's here
- Product guides — Getting started, Organizations, and Billing for people using the app.
- Onboarding — the one answer to "what does the human ever do?" and how to start a new project from the template.
- Architecture — the living engineering blueprint (system context, containers, components, and the generated resource inventory).
- Runbooks — deploy, rollback, restore, rotate, target switch, and on-call.
- Decisions (ADRs) — the numbered, append-only decision record.
The engineering sections are published here because this demo instance sets
publish_internal_docs: true. A generated project leaves that off and publishes
only its product guides. Internal reports, the worklog, plans, and the brief are
never published (enforced in the docs build).