ButtonGriddle Field Test Guide

One page for trying ButtonGriddle with a real client. "Professional" below means whoever builds the boards (OT/SLP/ATP/teacher); "staff" means whoever presents choices day to day (DSP, caregiver, family).

What we're testing: can a professional build context boards for a real client, hand the tablet to staff, and can staff present choices and confirm understanding — without ever needing edit mode?

Everything stays on the tablet. No account, no cloud, works fully offline. Photos leave the device only inside backup files you export yourself.

1. Setup (professional, ~15 minutes)

Install: open the app URL in Chrome on the tablet → menu (⋮) → Add to Home screen / Install app. Launch it once from the new icon — after that it works with no internet.
Enter edit mode: tap the faint ⌗ in the top-right corner 7 times quickly. The first time, you'll set a 4-digit passcode — this is the only thing separating staff view from edit mode.
Optional head start: Settings → Import backup → choose demo-boards.json (get it from the project repo, demo/ folder). This replaces the starter board with four example context boards: Meals, Drinks & Snacks, Activities, Comfort.
Make it real. Demo boards are text-only on purpose — real boards work best with photos of the client's actual items (their cup, their puzzle, the actual van). In edit mode: tap a button to edit it (photo, label, spoken phrase, color), tap an empty cell to add one, hold and drag to rearrange. ‹ Boards (top left) goes to the board list to add, rename, or delete boards.
Voice check: Settings → pick a voice and speed the client responds to. The 🔊 Test button in any button editor previews it.
Lock it in: Settings → Save current board as original setup. This is the known-good state that Reset returns to if edits go sideways. Then tap Done to leave edit mode, and hand over the tablet.

2. Daily use (staff — no passcode needed)

Tap a picture — the tablet speaks it.
‹ Boards (top left) switches context: meals at lunch, activities in the afternoon. (Only appears when there's more than one board.)
✓ Check (bottom right) opens a full-screen Yes / No / Not sure to confirm you understood: "You want the sandwich?" → they answer on screen.
Offering just 2–3 choices: enter edit mode (⌗ ×7 + passcode), tap Hide on the buttons to set aside, tap Done. Hidden buttons come back the same way. We know this round-trip is clunky — see feedback question 2.

3. If something goes wrong

Bad edit / accidental delete: edit mode → Settings → Restore previous version.
Board is a mess: Settings → Reset to original setup — returns to the saved known-good state.
Forgot the passcode: after 5 wrong tries, a "Forgot passcode?" option appears. It resets the board to the original setup and lets you set a new passcode; the current board is kept as a restorable snapshot.
Habit: export a backup (Settings → Export backup) after any big board-building session and keep the file somewhere safe — it contains the photos.

4. What to observe

How long from "offer a choice" to the client indicating one?
Does staff actually use the ✓ Check screen, or confirm verbally?
Accidental taps? (Settings has Hold to activate and Ignore repeat taps if touch control is an issue.)
Are buttons big enough? Too many per screen? (Grid size is per-board in Settings.)
Is the voice intelligible and acceptable to the client?
Does staff ever get stuck needing something behind the passcode?

5. Feedback we need

Whose tablet should this live on — the client's own device, or a staff device shared across clients?
Presenting 2–3 options in the moment: is hide/show + separate boards workable, or does this need a dedicated quick-present mode?
The check screen: are "Yes / No / Not sure" the right three words? Should they be symbols? Configurable per client?
What's missing most: first/then supports, visual timers, visual schedules, checklists, comfort/pain check-ins — what would you reach for next?

ButtonGriddle is a general participation support tool, not a medical device.