Adr
ADR 0008 — Markdown-first report generation
Why reports are generated as Markdown rather than PDF first.
- Status: Accepted
- Date: 2026-07-13
Context
Kredal produces founder readiness reports and bank application packs. These must be deterministic, reviewable, easy to store, and quick to ship in the MVP. PDF rendering adds a server-side dependency and slows iteration.
Decision
Generate reports as Markdown from deterministic templates (src/lib/reports/templates.ts),
store the Markdown in the reports table, and render it in the app with copy and
export-to-.md. Every report opens with the mandatory disclaimer. PDF export is deferred.
Consequences
- Positive: deterministic and unit-testable (tests assert the disclaimer and key content); cheap to store and diff; trivially portable.
- Negative: no native PDF yet. Founders copy/export Markdown for now; a server-side PDF renderer can be added later without changing the templates.