# Jamper · Click-by-Click HITL Runbook This runbook covers the **four phases** of the brief, with explicit human-in-the-loop (HITL) breakpoints. Follow steps in order. Every step is either a one-time setup task, a paste-and-save, or a confirmation gate. > **Estimated total time:** 3–5 hours of merchant attention spread across all four phases. --- ## Phase 1 · Initial Store Provisioning, Core Architecture & Theme Optimisation ### Step 1.1 — Create the Shopify store (5 min) 1. Go to and start a 3-day free trial (then $1/month for 3 months). 2. Store name: **Jamper**. Industry: *Pets*. Country/region: *Australia*. 3. After signup you'll land in **Shopify Admin → Home**. ### Step 1.2 — Settings → General (3 min) - **Store details → Store name:** Jamper. - **Store details → Sender email:** `jampergroup@gmail.com`. - **Customer accounts:** Off (use guest checkout for fastest conversion). - **Standards & Formats → Currency display:** USD (Shopify Markets handles conversion). ### Step 1.3 — Settings → Markets (5 min) - **Add markets:** Australia, United States, United Kingdom, Canada, New Zealand. - **Pricing:** select *Round prices* → leave at default (we already charm-rounded in cents). - **Domains:** keep `jamper.myshopify.com` until you've registered a real domain. ### Step 1.4 — Install the Dawn theme (1 min) - **Online Store → Themes**. Dawn is already there as the default. Click *Customize*. ### Step 1.5 — Apply the Dawn re-skin (15 min) 1. Open `dawn-reskin-instructions.md` from this package. 2. Follow sections **1 → 9** in order. The CSS prepend is the most important step. 3. Save the theme. ### Step 1.6 — Upload brand assets (3 min) - Logo: upload `brand-assets/jamper-logo.png`. - Favicon: same file. - Hero image (used by the Image banner section): upload `brand-assets/jamper-hero.jpg`. ### Step 1.7 — Create the 4 legal pages + About (10 min) - **Online Store → Pages → Add page** for each of: - About Us - Privacy Policy - Terms of Service - Refund & Return Policy - Shipping & Logistics Policy - For each, click *Show HTML* in the editor and paste the body of the corresponding HTML file from `legal-pages/`. ### Step 1.8 — Settings → Policies (3 min) - **Settings → Policies** auto-links to the 4 legal pages from your checkout footer. Click *Insert template* on each and replace with the matching HTML body. ### 🔴 HITL Breakpoint 1 — Phase 1 sign-off > ✅ Confirm before continuing: > - Storefront preview loads with terracotta primary buttons, cream background and Inter font. > - Logo and favicon are visible. > - About + 4 legal pages exist and read correctly. > - You have signed up for AutoDS at ($1 trial, then $39+/month). --- ## Phase 2 · Product Sourcing, Catalog Architecture & Copywriting ### Step 2.1 — Connect AutoDS to Shopify (5 min) - AutoDS dashboard → *Stores* → *Add store* → *Shopify*. Authenticate the OAuth flow. ### Step 2.2 — Find the 10 supplier products (30–60 min) For each row in `jamper-products.csv`, search AutoDS by category and supplier rating ≥ 4.5★. The pre-set `Variant SKU` values (`ADS-PT-10042` etc.) are placeholders — replace them with the real AutoDS product IDs once you've selected suppliers in your AutoDS account. Copy-paste this mapping back into the CSV before importing. ### Step 2.3 — Import the products CSV (3 min) - **Products → Import** in Shopify Admin. - Upload the (now-updated) `jamper-products.csv`. - Map columns automatically (Shopify will auto-detect every column we provide). - Click *Import products*. Verify 10 products with 26 variants land successfully. ### 🔴 HITL Breakpoint 2 — Catalog sign-off > ✅ Confirm before continuing: > - All 10 products visible in *Products* tab. > - Each product page shows the right hero image, body copy, retail price (matches the Engineering Hand-off Log table on the live preview), and variant options. > - Cost per item is set on each variant (used for margin reports). --- ## Phase 3 · CRO, Reviews, Trust Badges & Conversion Plumbing ### Step 3.1 — Reviews (Shopify Product Reviews, free) (10 min) - Install **Shopify Product Reviews** from the Shopify App Store (free, native). - For each of the 10 products, paste the seed reviews from `jamper-reviews.csv` (provided) using the app's bulk-import CSV importer. ### Step 3.2 — Trust badges block (5 min) - Open the Default product template in *Customize*. Add a **Custom liquid** block under the Buy buttons; paste the contents of `theme-snippets/jamper-trust-badges.liquid`. ### Step 3.3 — Checkout (5 min) - **Settings → Checkout → Customer accounts**: *Don't require* (guest checkout). - **Checkout → Form options**: Phone *Required*; Address line 2 *Optional*; Company *Hidden*. - **Checkout → Abandoned checkout emails**: enabled. First reminder 1 hour, second reminder 24 hours. ### Step 3.4 — Payments (10 min) - **Settings → Payments → Activate Shopify Payments**. Provide your bank details and ABN/SSN/etc. - Add **PayPal Express** (sign in with your PayPal account). - Add **Afterpay** (provide merchant ID). - Apple Pay, Google Pay, Shop Pay are auto-enabled when Shopify Payments is on. --- ## Phase 4 · Tracking, AI Agent & Final Hand-off ### Step 4.1 — Meta Pixel + Conversions API (15 min) 1. Create a Meta Business account at . 2. **Events Manager → Connect data sources → Web → Pixel**. Name it *Jamper*. 3. Copy the **Pixel ID** (16 digits). 4. **Settings → Conversions API → Generate access token**. Copy the long token. 5. Open `theme-snippets/jamper-pixels-api.liquid` from this package; replace `{{ META_PIXEL_ID }}` with your Pixel ID. 6. **Online Store → Customer events → Custom pixel**. Paste the entire snippet. Set *Customer privacy → Permission* to "Required" (enables consent gating). 7. **Settings → Customer privacy** → enable cookie banner. ### Step 4.2 — GA4 Measurement (10 min) 1. → Create a property → *Jamper* → Web data stream → enter your *.myshopify.com URL. 2. Copy the **Measurement ID** (`G-XXXXXXXXXX`). 3. In the same Custom pixel as 4.1, replace `{{ GA4_MEASUREMENT_ID }}` with your Measurement ID. Save. ### Step 4.3 — Custom AI Agent (skip if using Tidio/Gorgias) - The live preview ships with a custom OpenAI-powered chat widget. To replicate in Shopify: 1. Deploy a small Cloudflare Worker (or any serverless endpoint) that calls OpenAI's Chat Completions API with the system prompt found in `server/routers.ts` (function `SYSTEM_PROMPT`). 2. Add a small `