Architectural Decision Records
This directory captures significant architectural decisions made in the Owlat project. Each record explains the context, the decision, and the trade-offs...
This directory captures significant architectural decisions made in the Owlat project. Each record explains the context, the decision, and the trade-offs involved.
Format
We use a lightweight ADR format:
# ADR-NNN: Title
- Status: Accepted | Superseded | Deprecated
- Date: YYYY-MM-DD
- Context: What prompted this decision
- Decision: What was decided
- Consequences: Trade-offs, what this enables/prevents
Decisions
| ADR | Title | Status |
|---|---|---|
| 001 | Custom email renderer over MJML | Accepted |
| 002 | Convex as backend | Accepted |
| 003 | Notion-like email builder | Accepted |
| 004 | Monorepo with Bun workspaces | Accepted |
Adding a New ADR
- Create a new file:
NNN-short-title.md(use the next available number) - Follow the format above
- Add a row to the table in this index
- Submit with your PR