docs: root README — run instructions, data map, the 3 Steve-gated switches

015575977e8ede44b08841f5ce19f1f879962af9 · 2026-07-02 07:23:22 -0700 · Steve Abrams

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Files touched

A README.md

Diff

commit 015575977e8ede44b08841f5ce19f1f879962af9
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Thu Jul 2 07:23:22 2026 -0700

    docs: root README — run instructions, data map, the 3 Steve-gated switches
    
    Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..59b8c87
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Pattern Vault
+
+Digital-license storefront for Wallpaper's Back original designs — sells **licenses**
+(digital single-use / commercial print / exclusive) to the seamless patterns as digital
+assets. Sibling of wallpapersback.com, which sells the printed wallpaper.
+
+## Run
+
+```sh
+npm start            # or: pm2 restart pattern-vault
+open http://127.0.0.1:9779   # Basic Auth admin / DW2024!
+```
+
+- `data/catalog.json` — 24 WPB designs with license tiers (source: wallpapersback.com catalog)
+- `data/license-events.jsonl` — append-only checkout/inquiry log
+- `public/index.html` — grid with sort + density slider (localStorage-persisted, per DW spec)
+- `scripts/build-kits.js` — regenerates `kits/` (Spoonflower / Etsy / Creative Market CSVs + images)
+
+## Gates (Steve-only switches)
+
+1. **Stripe TEST key** — paste an `sk_test_` key into `.env` (see `.env.example`) to turn
+   inquiries into real TEST-mode checkouts. The server refuses `sk_live_` keys outright.
+2. **PUBLIC_VAULT=1** — drops Basic Auth and opens the site. Never set by agents.
+3. **Marketplace uploads** — `kits/` CSVs are ready, but account creation + uploads are gated
+   (see `kits/README.md`). Full-res 150-DPI masters live on Kamatera prod (wallco-tif) and
+   pulling them is a gated prod step; the kit images are web-res previews.

← 1fe1588 initial: Pattern Vault digital-license store (24 WPB designs · back to Pattern Vault · signup handoff: Spoonflower=existing login, 3 marketplaces=S 63bed8a →