diff --git a/docs/deploy-replit.md b/docs/deploy-replit.md
new file mode 100644
index 0000000..4e9bb72
--- /dev/null
+++ b/docs/deploy-replit.md
@@ -0,0 +1,28 @@
+# Deploy to Replit
+
+Recommended deployment platform. Handles Node.js, PostgreSQL, secrets, and HTTPS out of the box.
+
+**Cost:** ~$25–50/month on Replit Core.
+
+---
+
+## Steps
+
+1. **Import**: replit.com → New Repl → Import from Git → `https://git.wellspr.ing/WellBuilder/notshop-bundle`
+
+2. **Secrets**: Add in the Secrets tab:
+   - `AUTHNET_API_LOGIN_ID`
+   - `AUTHNET_TRANSACTION_KEY`
+   - `AUTHNET_ENV` (sandbox or production)
+   - `DATABASE_URL` (see step 3)
+   - `SHOPIFY_STOREFRONT_TOKEN`
+   - `SHOPIFY_STORE_DOMAIN`
+   - `SESSION_SECRET` (any long random string)
+
+3. **Database**: Tools → Database → Create PostgreSQL → copy `DATABASE_URL` into Secrets → Shell: `npm run db:migrate`
+
+4. **Run**: Click Run, then in the Shell: `npm run catalog:import`
+
+5. **Publish**: Deploy → Publish → add your custom domain in Repl settings → update DNS CNAME.
+
+Or use Fly.io in front of Replit for edge routing and traffic splitting — see [fly-routing.md](fly-routing.md).