Repository navigation
Decisions Log
mdostal edited this page Oct 16, 2026
·
1 revision
A short index into the real design-discussion docs behind past decisions. Each links to the full reasoning rather than duplicating it — read the linked doc in the repo for the complete discussion, scope, and risk assessment.
All paths are relative to the repo root, under .pHive/epics/<epic>/docs/design-discussion.md.
| Decision | Epic | Doc |
|---|---|---|
| Brand colors, typography, and logo mark selection | framework-brand-system |
design-discussion.md |
| Giving each demo store a genuinely different persistence backend | per-demo-backend-diversity |
design-discussion.md |
| Accepting free-tier backend downtime + building graceful degradation and a keep-alive job | free-tier-resilience-and-keepalive |
design-discussion.md |
| Docs vs. wiki vs. examples: where different kinds of content should live | docs-wiki-examples-architecture |
design-discussion.md |
| Single-tenant mode + separately-deployed sample store URLs | separate-deployed-sample-stores |
design-discussion.md |
| Printful-first dropship/merch fulfillment, structured shipping addresses | dropship-merch-address-wiring |
design-discussion.md |
| Why Mercatus Liber over existing free/OSS commerce platforms | (repo root) |
shop/.pHive/epics/v1-launch/docs/oss-cart-cba.md (cited from the README's "Why" section) |
For the full list of every epic's own design-discussion doc (not just the ones above),
browse .pHive/epics/*/docs/design-discussion.md in the repo directly.