docs: Digital Downloads app delivery runbook (chosen over webhook/token path)

84a88cfb6659b230724a527432e9fcdd664919e3 · 2026-05-29 08:07:53 -0700 · Steve Abrams
Files touched

A docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md
Diff

commit 84a88cfb6659b230724a527432e9fcdd664919e3
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Fri May 29 08:07:53 2026 -0700

    docs: Digital Downloads app delivery runbook (chosen over webhook/token path)
---
 docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md | 52 +++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md b/docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md
new file mode 100644
index 0000000..8fc6115
--- /dev/null
+++ b/docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md
@@ -0,0 +1,52 @@
+# Shopify Digital Downloads app — delivery setup (chosen path, 2026-05-29)
+
+**Decision (DTD 2026-05-29):** deliver the 3 wallco.ai mini-pack bundles via Shopify's
+native **Digital Downloads** app instead of the wallco.ai webhook + token system.
+
+**Why this over the webhook:** the app auto-delivers a download link on the order
+confirmation page AND in the confirmation email — zero per-order work, Shopify handles
+re-download links and download limits. The `orders/paid` webhook handler + token DB
+become **redundant** for these bundles (keep them dormant as a fallback; don't delete).
+
+**Hard limitation:** the Digital Downloads app has **no Admin API**. Attaching a file
+to a product is UI-only. This whole doc is therefore a manual Shopify-admin runbook —
+nothing here can be scripted.
+
+## Files staged for you
+
+`~/Desktop/wallco-shopify-downloads/` — drag-drop these into the app:
+
+| Upload this file                 | …to this product                                                              |
+|----------------------------------|-------------------------------------------------------------------------------|
+| `Cactus-2-Pack.zip` (5.3 MB)     | `cactus-2-pack-seamless-wallpaper-bundle-mini-pack-digital-download`           |
+| `Designer-Zoo-Calm-2-Pack.zip` (3.1 MB) | `designer-zoo-calm-2-pack-seamless-wallpaper-bundle-mini-pack-digital-download` |
+| `Drunk-Monkeys-V2-1-Pack.zip` (7.3 MB)  | `drunk-monkeys-v2-1-pack-seamless-wallpaper-bundle-mini-pack-digital-download`  |
+
+Each ZIP = `<id>_source_1024.png` + `<id>_print_3600.png` per design + `cover_grid.png` + `README.txt`. Verified intact.
+
+## Steps (~5 min, all in Shopify admin for the designerwallcoverings.com store)
+
+1. **Install the app** (if not already): Shopify admin → **Apps** → search **"Digital Downloads"**
+   (Shopify-built, free) → Install. If it's already installed it shows under Apps.
+
+2. **Open Digital Downloads** → it lists products. Click **"Add file"** / select a product.
+
+3. For each of the 3 products above:
+   - Find the product (search by handle/title).
+   - Upload the matching ZIP from `~/Desktop/wallco-shopify-downloads/`.
+   - Confirm the variant is marked **"This is a digital product or service"** so no
+     shipping is requested at checkout. (The app sets the digital flag when you attach a file.)
+
+4. **Test:** place a $0/test order on one bundle (or use a Bogus Gateway / draft order
+   marked paid) → confirm the **download link appears on the order-status page** and in
+   the **order confirmation email**.
+
+## After it works
+
+- The wallco.ai `orders/paid` webhook + `wallco_download_tokens` system are no longer the
+  delivery path for these 3 bundles. Leave the code in place (dormant fallback); no need
+  to register the webhook in Shopify after all.
+- The `wallco_ai.bundle_download_url` / `bundle_download_file_id` metafields set by
+  `attach-shopify-bundle-files.js` are also redundant for delivery now — harmless to keep.
+- New future bundles: re-run `attach-shopify-bundle-files.js` only if you want the ZIP
+  hosted on Shopify's CDN; for delivery, just attach the same ZIP in the Digital Downloads app.
← 52f07a5 chore(gitignore): ignore timestamped *.bak.* runtime backups · back to Wallco Ai · Update Claude model IDs to claude-opus-4-8 (Opus 4.8 upgrade 692c3ba →