From 3b906ac9748425ff2360ddfaae030775b3d9a58c Mon Sep 17 00:00:00 2001
From: WellBuilder Admin <admin@wellspr.ing>
Date: Tue, 26 May 2026 16:13:28 +0000
Subject: [PATCH] Add README.md

---
 README.md | 77 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7531f09
--- /dev/null
+++ b/README.md
@@ -0,0 +1,77 @@
+# notshop-bundle
+
+**Sovereign commerce stack** — exit Shopify, own your commerce.
+MIT license. Built in production by NaturoMedica (Naturologie.com). Deposited to WellSpr.ing public git, April 2026.
+
+## What this is
+
+This is the stack that replaced Shopify Plus at Naturologie.com after NaturoMedica documented seven layers of undisclosed Shopify fees across four months. It replaces Shopify Plus ($2,300+/mo platform fee alone) with a self-hosted stack costing ~$75–100/month total.
+
+Full extraction analysis: [NotShop.org](https://notshop.org)
+
+## Stack
+
+| Component | Provider | Cost |
+|---|---|---|
+| Web deployment | Replit | ~$25–50/mo |
+| Edge routing | Fly.io | ~$5/mo |
+| DNS | Bunny.net | ~$1/mo |
+| Domain | Porkbun | ~$12/yr |
+| Payments | Authorize.net | 2.9% + $0.30/txn |
+| Shop Campaigns | None | $0 |
+| **Total** | | **~$75–100/mo** |
+
+vs. documented Shopify Plus cost: **$3,609+/mo** (platform + Shop Campaigns + POS + app fees)
+
+## What you get
+
+- React + Express storefront (TypeScript, Vite, Tailwind CSS)
+- Authorize.net payment processing — no Shopify Payments lock-in
+- Product catalog import from Shopify Storefront API (read-only, for migration)
+- **Parallel migration mode** — run alongside Shopify until you are confident, then cut over
+- Order management and customer accounts
+- PostgreSQL for order and product storage
+
+## The first action to take right now
+
+**Pause Shop Campaigns before anything else.**
+
+Admin → Marketing → Shop Campaigns → Pause.
+
+You lose no existing customers. You stop the non-refundable CAC extraction immediately.
+This one action saves the average merchant $200–800/month while the rest of the migration proceeds.
+
+## Quick start
+
+```bash
+git clone https://git.wellspr.ing/WellBuilder/notshop-bundle
+cd notshop-bundle
+npm i
+cp .env.example .env   # fill in your credentials
+npm run dev
+```
+
+Then import your product catalog:
+
+```bash
+npm run catalog:import
+```
+
+## Documentation
+
+- [Parallel Migration Guide](docs/parallel-migration.md)
+- [Storefront API Sync](docs/storefront-api.md)
+- [Authorize.net Setup](docs/authorize-net.md)
+- [Deploy to Replit](docs/deploy-replit.md)
+- [Fly.io Edge Routing](docs/fly-routing.md)
+
+## License
+
+MIT — use freely, fork freely, build on it, sell products built with it.
+
+Authored by NaturoMedica / Naturologie.com. Deposited to the WellSpr.ing public commons.
+
+---
+
+> "Shop doesn't sell for you. Shop sells you."
+> — [NotShop.org](https://notshop.org)