Skip to content

ADR 0002: One repo, standalone shops

  • Status: Accepted
  • Date: 2026-09-11

Context

The shops share patterns (showcase mode, assistants, branded email) but must demonstrate independence: each is a realistic single-merchant build, and demos must fail in isolation.

Decision

One repository solidus-demos holds five standalone Rails apps in subdirectories, each with its own Gemfile, database, Dockerfile and Kamal config. Shared ideas are copied and adapted deliberately (a platform extraction is a later, separate decision), with platform foundation tasks tracked in ClickUp.

Consequences

Cross-shop changes are explicit copies, so one shop can never break another; the cost is copy drift, which the storefront copy pass incident showed and the docs rule mitigates.