Common questions about DreamBees Art as an open-source Shopify-class platform.
A self-hosted ecommerce monolith: Next.js storefront + admin + Firestore + Stripe. Full source access; you own data and infrastructure.
Shopify is hosted SaaS with themes and apps. DreamBees Art is deployable source with explicit checkout/inventory/refund protocols you can read and patch.
Default demo merchant branding in this repo. Replace via admin settings and src/domain/seo/brand.ts.
Not out of the box. One deployment = one merchant Firestore project. Multi-tenant would be a major fork.
Almost always webhooks. Local: run stripe listen. Production: register live webhook URL and set STRIPE_WEBHOOK_SECRET. See troubleshooting.md § Webhooks.
Installs deps, creates .env, seeds Firestore with sample catalog + admin user. See onboarding.md.
admin@woodbine.com / admin-password-123 — local dev only.
To cage money and stock mutations: checkout, refunds, inventory, admin. Routes stay thin; behavior is testable. commerce-protocol-frozen.md
No — use services.checkout or services.refunds through the appropriate protocol.
No — product PATCH rejects raw stock. Use admin inventory batch adjust. inventory.md
Decision tree: contributing-commerce.md
Yes for production. Call POST /api/system/cleanup-orders with SYSTEM_JOB_TOKEN on a schedule. runbook.md
Admin reconciliation → retry_recovery with reason. flows.md § Reconciliation
No — same idempotencyKey returns { duplicate: true } without a second Stripe refund.
Storefront or checkout UI changes:
npm run test:storefront-release
npm run test:e2e:checkout-smoke # recommended for checkout UIAll protocol changes also need verification ladders:
npm test -- --run src/tests/*-verification-ladder.test.tstesting.md · storefront-release.md
npm run benchmark:order-flow — Core throughput with in-memory adapters, not production SLA.
No. Set GEMINI_API_KEY to enable; commerce works without it.
Optional Brevo (BREVO_*). Password reset and notifications depend on configuration.
Conceptual guide — no automated importer. migration-from-shopify.md
| Topic | Doc |
|---|---|
| Setup | onboarding.md |
| Cheat sheet | quick-reference.md |
| Debug | troubleshooting.md |
| Deploy | deployment.md |
| Terms | glossary.md |
| Full index | index.md |