Guest siteRSVPAdminHelp / How-to

Help & How-to

Welcome! This page is for whoever is taking over and managing the wedding site (that's you, friend). It covers what the project is, where things live, how to run it, how to deploy it, and how to help the couple use the admin. It lives in the repo at mockup/help.html — just double-click it to open in a browser.

1. What this is2. Where things stand3. Repo map4. Run the mockup locally 5. Build the real thing (phases)6. Deploy on Coolify7. Environment variables8. Backups & restore 9. Couple's how-to (admin)10. Common tasks cheat sheet11. Troubleshooting12. Open questions

1. What this is

A one-wedding website for Nathan & Andrea. Two halves:

Design is "inspired by" a Canva template — the feel only. Don't reuse that creator's photos, names or copy. The full brief is in docs/spec/SPEC.md with screenshots in docs/spec/references/.

Non-goals: gift tracking, payments, seating charts, multiple weddings, guest accounts, livestreaming. Say no to these; it keeps the site cheap and simple.

2. Where things stand

Right now there is only a static mockup — no database, no emails, no login. All names (Nathan & Andrea), the date (June 12, 2027), venue and photos are placeholders.
PieceMockup status
Guest site (index.html)Done as a visual mock: intro, hero, countdown (live), details, schedule, travel, FAQ, registry, gallery, footer.
RSVP form (rsvp.html)Form works visually, shows a thank-you. Nothing is saved. Honeypot field is in place.
Admin (admin/index.html)All 9 screens drawn with sample data. Only Look & feel actually works (colours/fonts saved in your browser and applied to the guest site).
Backend, DB, email, auth, DockerNot started. See phases below.

3. Repo map

mockup/
  index.html        guest home page (all sections on one page)
  rsvp.html         RSVP form page
  help.html         this page
  admin/index.html  admin mockup (tabs)
  assets/
    style.css       theme tokens (:root variables) + all guest styling
    app.js          intro, countdown, RSVP behaviour, applies saved theme
    photo-*.svg     placeholder "photos"
docs/spec/
  SPEC.md           the build spec — source of truth
  references/       8 design screenshots
README.md           quick start

Theme system: all colours/fonts live in assets/theme.js (the preset list and the theme keys: bg, bgDark, text, card, cardText, accent, font, texture, intro) and are applied as CSS variables defined at the top of assets/style.css. The admin editor and the guest site both use that one file. In the real app, save this same JSON in settings.theme and call the same apply function. To add a preset, add one line to PRESETS.

Easy edits in the mockup: colours/fonts → top of assets/style.css. Placeholder names/date → search Nathan & Andrea and WEDDING in assets/app.js.

4. Run the mockup locally

Easiest: double-click mockup/index.html. Fonts load from Google Fonts, so you need internet. Or serve it (needed if you later add fetch calls):

python serve.py
# then open http://localhost:8080  (it also prints a network link to share on the same Wi-Fi)

Run it from the repo root. serve.py turns caching off so your edits show on refresh.

Tips: use the black bar at the top of every page to jump around. Replay intro clears the "already opened" memory. Add #skip to the URL to bypass the intro. Use your browser's phone-size view (F12 → device toolbar) — mobile is the priority.

5. Build the real thing (phases)

From the spec. Stop and show Nathan after each phase.

#PhaseDone when
1Skeleton + design: Next.js (App Router, TS), Dockerfile, theme tokens, intro, home, countdown, placeholder content; deployed to CoolifyLive URL shows the mockup look on a phone
2Database (SQLite + Drizzle/Prisma), admin login, guest CRUD, CSV import, personal links /i/<code>Add a guest, copy their link, it greets them by name
3RSVP form, admin RSVP table, dashboard, CSV exportGuest RSVPs in under a minute and can edit later
4Invitations: email templates (Resend/SMTP), sending, open tracking, remindersSend a test, see "opened"
5Admin editors: photos (sharp resize, B&W), theme, content, section toggles, live previewCouple changes colours + photos with no code
6Polish: OG images, accessibility, performance, backups, final READMEAcceptance checks in the spec pass

Keep it to one container: SQLite on a volume, photos on disk, no extra services. The mockup's CSS variables (--bg, --text, --card, --accent, fonts) are exactly the theme tokens the admin editor should write.

6. Deploy on Coolify

  1. Push the repo to a private GitHub repository.
  2. In Coolify: New Resource → Private Repository → pick it → Build Pack: Dockerfile.
  3. Add the env vars in section 7.
  4. Add persistent volumes: /data/db and /data/uploads. Without these, a redeploy wipes guests and photos.
  5. Set health check path (e.g. /api/health), turn on auto-deploy for main.
  6. Add the custom domain; Coolify handles HTTPS.

7. Environment variables

NameWhat
ADMIN_EMAIL, ADMIN_PASSWORDFirst admin account (created on first run). Change the password after logging in.
SESSION_SECRETLong random string for login sessions. Never commit it.
RESEND_API_KEYEmail sending (or SMTP vars if swapped).
EMAIL_FROMSender address — must be verified with the email provider.
SITE_URLPublic URL, used in personal links and emails.

Never put real secrets in git. Keep a .env.example with blanks and a .env (already git-ignored) locally.

8. Backups & restore

9. Couple's how-to (admin)

Share this section with Nathan & Andrea. Sign in at your-domain/admin with your email and password.

Add guests

Guests → + Add household. A household is a person or family sharing one invitation. Set how many plus-ones they may bring and a group (family, friends…). Many at once? Import CSV (columns: household name, member names, email, phone, plus-ones, group).

Send a save-the-date

  1. Invitations → choose Save the date.
  2. Edit the subject and message. Keep {{link}} — that's each guest's personal link.
  3. Click Send test to me first and check it on your phone.
  4. Click Send to selected… or all.

See who opened it & nudge people

Statuses: not sent → sent → delivered → opened → responded. Use Remind non-responders on the Dashboard (a single click).

Change how it looks

Look & feel: pick one of nine ready-made themes (Olive Garden, Sage & Cream, Dusty Rose, Navy & Gold and more), then tweak any colour if you like — page colour, text, cards, buttons/accent — plus the font pairing, paper texture and the intro screen. The phone preview on the right is the real site and updates instantly. The Readability check warns you if text would be hard to read; Make page text readable fixes it in one click. Click Save theme to publish; Reset to default goes back to the original olive look.

Photos

Photos → Upload. Drag to reorder, add captions, mark one as the hero, tick B&W for the photo-booth look. Pick 3–4 for the intro strip in the strip builder. Portrait or square photos work best; they're resized automatically.

Edit words & hide sections

Content: names, date, venue, the handwritten note, schedule, FAQ, travel, registry links. Untick a section to hide it from guests.

Get the final headcount

RSVPs → Export CSV — one for the caterer (meals, dietary) and one for the printer (names, addresses).

A guest lost their link

Guests → find the household → Copy link (or QR) and resend it. They can change their answer from the same link until the deadline.

10. Common tasks cheat sheet

I want to…Do this
Change the dateAdmin → Content (and Settings → timezone). Countdown follows automatically.
Extend the RSVP deadlineAdmin → Settings → RSVP deadline.
Fix a guest's RSVPAdmin → RSVPs → Edit.
Add a second adminAdmin → Settings → + Add admin.
Go live with a passwordAdmin → Settings → Site password.
Update the app (developer)Commit and push to main; Coolify redeploys.

11. Troubleshooting

12. Open questions to confirm with the couple