How can we help?

A digital wallet for the barcode loyalty cards cluttering your pocket. Scan a card once, and the right one appears at the right store — no fumbling through plastic at checkout.

Everything runs on your device. No account. No sign-up. No cloud sync.

1. Tap the + button on the main deck.
2. Point your iPhone camera at the barcode on the back of a physical loyalty card.
3. Give the card a name (or accept the suggested one) and pick a color.
4. (Optional) Tap Add Location to set a geofence — the card will surface automatically when you arrive at the store.

Tap any card in your deck. The barcode fills the screen. Hand the phone to the cashier — they scan it the same way they'd scan a physical card.

If the barcode won't scan, increase your screen brightness to maximum and wipe the screen clean.

• Edit a card — Tap the card, then tap the pencil icon. You can change the name, color, category, notes, and barcode.
• Delete a card — Swipe left on a card in the deck, or open the card and tap the trash icon.
• Reorder cards — Long-press a card and drag it to a new position.

On the Add Card screen, tap Enter manually instead of using the camera. Type or paste the barcode number and pick the format.

Code 128, Code 39, EAN-13, UPC-A, QR, PDF417, and Aztec.

To notify you when you arrive at a store so the right card is ready. When you set a geofence on a card, the app monitors that area in the background — when you walk in, you get a notification with your card.

Geofencing only works in the background. "While Using the App" only checks your location when Hopscotch is open on screen — which defeats the point. To get automatic arrival notifications, choose Always Allow when prompted, or in Settings → Hopscotch → Location.

If you'd rather use "While Using," your saved geofences will still appear in the app, but arrival notifications won't fire.

Barely — typically 1–3% over a full day.

Geofencing is one of the most battery-efficient location features iOS offers. Hopscotch never turns on GPS. iOS handles region monitoring at the chip level using cell-tower and Wi-Fi signals your phone is already processing. The app stays asleep until you cross a geofence boundary.

An hour of GPS navigation drains more battery than a full day of Hopscotch geofencing.

iOS limits any single app to 20 simultaneously monitored regions. Hopscotch shows your remaining slots when you're getting close. You can toggle individual locations off without deleting them to free up a slot.

A few possible reasons:

• Location permission isn't "Always Allow" — check Settings → Hopscotch → Location.
• Notifications are off — check Settings → Hopscotch → Notifications.
• The geofence is too small — radii under 50m can miss arrivals due to GPS drift. Try 100m or wider.
• You entered from a "dead zone" — geofences depend on cell/Wi-Fi signals. Underground parking, large concrete buildings, or remote areas can delay detection.
• You're already inside the geofence — region monitoring fires on entry and exit. If you were already inside when you set it up, no entry event fires.

• Per location — Open a card and toggle the location off. Geofence is preserved, monitoring stops.
• System-wide for Hopscotch — Settings → Hopscotch → Location → set to "Never" or "While Using."
• Delete a location — Swipe to delete from the card detail view.

Long-press your home screen → tap + → search "Hopscotch" → pick a size (small, medium, or large) → tap Add Widget.

The widget always tries to show the card you're most likely to need right now. It ranks your cards in this order:

1. Pinned card — if you've pinned one, it always wins.
2. Inside a geofence — if you're currently at a saved store, that card surfaces.
3. Closest geofenced store — if you're not inside any, the nearest one ranks higher.
4. Most-used cards — cards you scan more often rank higher.
5. Most recently scanned — recency breaks ties.
6. Alphabetical — final fallback.

1. Long-press the Hopscotch widget on your home screen.
2. Tap Edit Widget.
3. Pick the card you want to stay on top.
4. Tap outside the widget to confirm.

The pinned card overrides Smart Sort. To go back to automatic, edit the widget and choose Smart Sort (or whichever option clears the selection).

Smart Sort surfaced a card that's closer to you or one you use more often. If you want to lock a specific card in place, pin it.

Settings → Hopscotch → Notifications → Allow.

Only geofence arrival notifications. No marketing. No engagement nudges. No "you haven't opened the app in a while" reminders. Ever.

When you arrive at a store, you may see one or two notifications depending on how you've set the card up:

Hopscotch app notifications

• Standard iOS banners — "You're at [Store]. Your [Card] is ready."
• Dismissible by swiping them away.
• Auto-clear after 15 minutes so they don't pile up on your lock screen for the rest of the day.

Apple Wallet pass notifications (only if you've added a card as a Wallet pass)

• Managed by iOS Wallet, not Hopscotch.
• Persist on the lock screen while you're inside the geofence so you can tap-and-hold at checkout without opening the app.
• iOS automatically removes them when you leave the area.
• To stop a specific pass from appearing on the lock screen: open the pass in Wallet → tap the ••• menu → toggle Suggest on Lock Screen off.

Open the card and toggle the location off. The geofence stays saved, but no Hopscotch notification fires. To also stop the Wallet pass from showing, use the Wallet Suggest on Lock Screen toggle described above.

Hopscotch installs automatically on a paired Apple Watch when your iPhone has the app installed and Watch is set to install new apps automatically. If it doesn't show up:

1. Open the Watch app on your iPhone.
2. Scroll to Available Apps → find Hopscotch → tap Install.

• View your full card deck
• Display any card's barcode for scanning at checkout
• Receive geofence arrival notifications from your iPhone

• Scan new cards — no camera on Apple Watch. Add cards on your iPhone.
• Set or edit geofences — manage locations on your iPhone.

Try in order:

1. Make sure both devices are on and within Bluetooth range.
2. Force-quit Hopscotch on iPhone, re-open it, wait 30 seconds.
3. Restart the Watch app from the Watch's home screen.
4. If still stuck, unpair and re-pair the Watch (last resort — preserves iPhone data).

• No account required. No sign-up, no login, no password, no email collection.
• All data lives on your iPhone. Cards, locations, and settings are stored locally in iOS's secure on-device storage.
• No cloud sync, no servers. Hopscotch has no backend, no analytics, no third-party trackers.
• Location data never leaves your device. iOS handles geofence monitoring locally; Hopscotch never sees raw coordinates or location history.

Read the full Privacy Policy.

Delete the app. There's nothing on a server to clean up.

If you use iCloud Backup, your cards are included automatically — same as any other app.

Clean the lens, improve lighting, hold the phone 6–8 inches from the barcode, and keep it steady. If the barcode is worn or damaged, tap Enter manually and type the number.

Crank screen brightness to max. Wipe the screen clean. Some older scanners struggle with phone screens — ask the cashier to type the number manually as a fallback.

See Location & Geofences — the most common cause is location permission set to "While Using" instead of "Always Allow."

iOS controls widget refresh timing. Open the Hopscotch app once — the widget refreshes after the app updates its data.

Force-quit the iPhone app, re-open, give the Watch 30 seconds to sync. If it persists, restart the Watch.

Settings → Hopscotch → toggle the relevant permission off, then back on.

Email hello@hopscotch.city with your iPhone model, iOS version, and what you were doing. Screenshots help.