From b34715f1520ff4f90a790203357b3e04bca7846e Mon Sep 17 00:00:00 2001
From: Kwaku Danso <72142185+cloud-dev101@users.noreply.github.com>
Date: Tue, 19 May 2026 23:00:11 +0100
Subject: [PATCH] fix(tier2-g): warmer Gate copy, generic example,
plain-language advanced controls
Round-three pass on the Gate card based on the latest UX feedback.
- Tagline: "Keeps your guest list yours" -> "Only your guests get in"
- Walk-through example now uses a neutral placeholder name (Sam)
instead of "Aunty Patience". GuestGuard's audience is wedding
couples, corporate planners, and party hosts as much as family
organisers, and Sam is at home in any of those contexts.
- The four-step "How does the Gate work?" expander was lightly
rewritten for warmth and to remove em-dashes; the mechanism it
describes is unchanged.
- Advanced strictness controls now open with a real explanation
rather than a one-liner about "band thresholds". The intro maps
the three sliders to the three reactions (watch / flag / refuse),
explains what the 0-100 numbers mean, and reassures hosts that
the presets above are still fine for almost everyone. Each
slider also gets a one-line caption tying its level dot (green
/ amber / red) to the user-visible effect.
- The trusted-networks "What this is and isn't" panel had its quotes
unwound into natural sentences; the empty-state copy was rewritten
in the second person; "No decisions to review yet" reworded.
- Pass through every user-visible string and replaced em-dashes
with periods, commas, or natural rephrasing. Em-dashes only remain
in code comments now (developer-facing, not on screen).
No behaviour changes; no backend changes; no API changes.
Co-Authored-By: Claude Opus 4.7 Keeps your guest list yours. Only your guests get in.
- Every guest gets their own personal invitation link — only meant for them.
- The Gate watches each link in the
- background and stops forwarded or shared invitations
- from being used by people who weren't on your list.
+ Every guest gets their own personal invitation link. Only one person was meant to use it.
+ The Gate quietly watches each link, so when
+ someone forwards or shares an invitation, the people it ends up with can't actually use it.
- Real invited guests don't notice it. You don't need to set anything up
- for it to work — the Gate is on by default with sensible settings.
+ Your invited guests won't notice a thing. There's nothing you need to set up for this
+ to work; the Gate runs in the background with sensible defaults from the moment your
+ event is live.
+ Here's the short version, using "Sam" as a stand-in for any one of your invited guests.
+
- When you send Aunty Patience her invitation, she gets her own personal link.
- That link only belongs to her.
+ When you send Sam an invitation, the link inside it is just for Sam. Nobody else
+ has the same link.
- The first time Aunty opens her link, the Gate quietly remembers a few details:
- her phone or browser, the general area she connected from, and the network shape.
- That becomes her "I'm me" signature.
+ The first time Sam opens it, the Gate quietly notes a few details about the visit:
+ the phone or browser Sam is on, roughly where Sam is in the world, and the kind of
+ network Sam is connected to. Together those become Sam's "this is really me" picture.
- Every time someone clicks Aunty's link after that — including Aunty herself —
- the Gate compares them to her signature. Same phone, similar location?
- They sail through. No signature yet? They become Aunty's signature on the first visit.
+ Every later click on Sam's link, including Sam coming back to update their reply,
+ gets compared to that first visit. If it looks like the same person, they go straight
+ through with no friction at all.
- If someone with a totally different phone on a totally different network tries to
- use Aunty's link — like a friend Aunty forwarded it to — the Gate notices. Depending
- on your strictness setting it'll either flag them for your review, or refuse them
- outright.
+ If a completely different device on a completely different network tries to use Sam's
+ link, say because Sam forwarded it to a friend, the Gate notices. Depending on how
+ strict you've set it, the Gate will either flag that click for you to review, or stop
+ the RSVP from going through at all.
- Worth knowing: guests can switch from mobile data
- to Wi-Fi or change rooms without being flagged — the Gate only cares about
- meaningful differences from the original visit, not normal day-to-day variation.
- If a real guest does ever get flagged (it happens), you can clear them with one click
- in Recent reviews below.
+ Worth knowing: guests can switch between Wi-Fi
+ and mobile data, change rooms, or open their link a few days later without being
+ flagged. The Gate only cares about meaningful differences from that first
+ visit, not normal day-to-day variation. And if a real guest of yours ever does end up
+ flagged, you can clear them with one click under Recent reviews below.
Gate
-
@@ -307,46 +307,49 @@ function verdictLabel(v: string) {
- These directly drive the band thresholds (0–100). The presets above just write - sensible triples for you. -
++ For most hosts, the four presets above are all you need. These sliders are + here if you want to fine-tune exactly when each reaction kicks in. +
++ As a click on a guest's link looks more and more different from their first + visit, the Gate moves through three reactions: watch silently, flag for your + review, or refuse the RSVP. The numbers below (from 0 to 100) are how much + difference is enough to trigger each one. Lower numbers make the Gate more + sensitive; higher numbers make it more forgiving. +
+- Adding a network here tells the Gate "always wave through clicks coming from - this Wi-Fi — they're already with me." It's useful when you're hosting at home - or the office and your guests will connect through your network. + Adding a network here tells the Gate to always wave through clicks coming from + that Wi-Fi, because the people on it are already with you. It's useful when + you're hosting at home or in the office and your guests will be on your network + when they reply.
It doesn't change how anyone else is treated. - Guests connecting from their own homes, mobile data, or anywhere else still get - the regular check — they're not suspected of anything by default. The Gate works - perfectly well with this list empty. + Guests connecting from their own homes, from mobile data, or from anywhere else + still get the regular check. They aren't suspected of anything just because they + aren't on your network. The Gate works perfectly well with this list empty, and + most events stay that way.
@@ -547,7 +586,7 @@ function verdictLabel(v: string) {- No trusted networks — and that's fine. The Gate is doing its job. + You haven't added any trusted networks, and that's fine. The Gate is still doing its job.
@@ -577,7 +616,7 @@ function verdictLabel(v: string) { and {{ feedback.length - 10 }} more. -No decisions to review yet — the gate hasn't flagged anyone.
+Nothing to review yet. The Gate hasn't flagged anyone.