heff-shop Saleor Monorepo
Multi-channel Saleor storefront β platform and forked storefront submodules, Docker smoke tests, and GraphQL channel wiring.
Project focus
Software
Key Features
Submodule-pinned platform stack
Forked storefront remote
Docker compose smoke path
Scope of work
Split checkout from the Stagea community platform into a focused Saleor monorepo:
- Pin
saleor-platformandsaleor-storefrontas Git submodules - Fork storefront to
heff0/saleor-storefrontfor controlled bumps and Heff-specific patches - Prove Docker compose boot path for API, worker, Postgres, Redis, dashboard
- Wire multi-channel GraphQL assumptions for future Heff retail experiments
- Keep README honest β test build, not production launch
Out of scope: payment provider production keys, PCI audit, full catalog migration from Stagea.
Timeline
| Phase | Window | Milestone |
|---|---|---|
| Repo bootstrap | Early 2025 | Initial submodule layout |
| Storefront fork | Spring 2025 | Retarget submodule to heff0/saleor-storefront |
| Docker smoke | Jun 2025 | Compose up β API + dashboard reachable |
| Channel sketch | Jun 2025 | Multi-channel GraphQL experiments documented |
Stack & BOM
| Submodule | Upstream | Role |
|---|---|---|
saleor-platform/ | saleor/saleor-platform | API, worker, Postgres, Redis, dashboard |
saleor-storefront/ | heff0/saleor-storefront (fork) | Next.js storefront |
| Service | Image / runtime |
|---|---|
| Saleor API | Docker (platform compose) |
| Postgres + Redis | Bundled with platform |
| Storefront | Node / Next β separate compose or dev server |
Deliverables
- Submodule structure with pinned SHAs
- Forked storefront remote under org control
- Documented
docker composesmoke procedure - Production deployment manifest (deferred)
- Heff catalog + fitment data import (deferred)
Outcomes
- Isolated commerce iteration from Stagea content velocity
- Learned submodule bump discipline β surprise
mainbreakage avoided - Established GraphQL channel patterns for future multi-store experiments
Risks
| Risk | Mitigation |
|---|---|
| Upstream Saleor drift | Pin SHAs; scheduled bump PRs |
| Submodule clone friction | Document git submodule update --init in README |
| Local Docker RAM | Smoke on trimmed compose profile |
Build log & narrative
Scope, timeline, and BOM live here. For decisions, debugging stories, and longer context, read the related blog post.
Read the blog postCompleted on: Jun 18, 2025