Setup Guide · 🦉 The 10X Owl

🦉 10X Invite Agent — Setup Guide (for Jeevan: paste → build → deploy → test)

Everything is plain paste-and-click. ONE project, ONE deployment — the same web app serves your dashboard AND records your guests' RSVP clicks. ~10 minutes end to end.

Part 1 — Build the product sheet (once)

  1. Create a new Google Sheet. Name it 10X Invite Agent.
  2. Extensions → Apps Script. Delete the default Code.gs content.
  3. Paste the 16 files from The Owl\ — one script file each (File ▸ + ▸ Script for .gs, + ▸ HTML for App and Sidebar). Names must match the filenames exactly (no .gs/.html typed — the editor adds it):
    Utils, Setup, Bank, Countdown, Writer, Columns, Send, Party, Drive, Attach, Import, License, Code, WebAppFull + HTML App, Sidebar.
  4. Project Settings ⚙ → tick Show "appsscript.json" → paste The Owl\appsscript.json over it. Save all.
  5. Back in the sheet: reload the browser tab. Menu 🦉 10X Invite Agent → ⚙️ Setup / Rebuild Workbook → authorize (Advanced → continue → Allow — normal for your own copy).
  6. You should see: Recipients (with the cream top section), Sent Box, Invite Messages, Field Bank tabs. ✅

Watch for curly quotes — if a paste errors, retype the quote characters in the editor. After ANY later code change: re-paste the changed file(s) and Deploy → Manage deployments → New version. Saving alone does nothing live.

Part 2 — Deploy the web app (once — dashboard + RSVP in one)

  1. Apps Script → Deploy → New deployment → Web app.
  2. Execute as: Me · Who has access: Anyone with the link → Deploy → copy the URL (ends /exec).
  3. Sheet menu → 🔗 Set the App link → paste. That's it — this ONE link now:
    - opens your dashboard (menu → 🦉 Open the Owl App — it adds your private access key automatically), and
    - powers the Yes / No / Maybe RSVP links in every email (guests hit the same address with their personal token).
  4. ⚠ The dashboard link the menu opens contains your access key — share that full link with your team only. Guests never need it: without the key, the bare address just shows a polite "use your invitation link" card. Your guest list is never visible to guests.

Part 3 — The 10-minute smoke test (do this before trusting it)

  1. App → ⚙️ Presets → load 💍 Wedding / Gala (or any).
  2. 🗂️ Common details → fill Event, Event Date (a real future date), Venue, Sign-off, Sender.
  3. ➕ Add guest → your own name + your own Gmail. Add a second with a different address if you have one.
  4. 🔄 Refresh → Days to Event fills, Ladder Step gets suggested.
  5. Tick the row(s) → ✍️ Invite Writer → Subject/Message fill by step.
  6. Click the row → the drawer opens → add yourself as CC → Save.
  7. Tick → ✅ Mark Ready → 👁 Preview + draft → check the preview shows the RSVP buttons → ✉️ Send ready.
  8. Open the email → click Yes → the confirmation page shows → back in the app, Refresh: RSVP = Yes, going = 1. 🎉
  9. Security spot-check: paste the email's RSVP link into an incognito window and delete everything after /exec — you should see the plain RSVP card, NOT your dashboard.
  10. 🔁 New Wave → Refresh → Writer → the same guest is ready for the next ladder email (a guest who clicked No stays untouched — that's deliberate).
  11. 📮 Sent history after an Archive shows the archived rows.

Part 4 — When you're ready to sell (the playbook, unchanged)

  1. Make a _Master copy; Start Fresh; blank the Common Details; clear the Sent Box (remove your PII); load a starter preset.
  2. In License.gs ON THE MASTER: required: true + your Gumroad permalink in product. Save. (Copies freeze code at copy-time — flip BEFORE sharing the link.)
  3. Share → Anyone with the link → Viewer. Sell link = the sheet URL with the tail swapped to /copy.
  4. Test the /copy link in incognito: fresh copy must demand a key before send.
  5. Buyers do Parts 1(5-6) and 2 themselves from their copy — their own auth, their own Gmail, their own deployment. Document Properties (app link, access key, license key) don't travel on copy — that's by design; each copy mints its own access key at Setup.

Daily flow (once set up)

Import/add guests → 🔄 Refresh → ✍️ Invite Writer → tick → ✅ Ready → 👁 Preview → ✉️ Send → RSVPs land by themselves. Later waves: 🔁 New Wave → Refresh → Writer → Ready → Send (decliners are skipped automatically). Event done: 📮 Archive.

Stuck? App 🔄 Refresh, or sheet menu 🩺 Health Check / Repair. Gmail limits: ~100/day free Gmail, ~1,500/day Workspace — send in batches of 25–50 (sends are auto-paced to keep Gmail's spam filter happy).