iOS App
Download
Section titled “Download”It is also deliberately narrower than the web app: feature parity is not the goal. The app covers the things that are better on a phone - a glanceable upcoming view, home screen widgets, and a save workflow for getting items into a list from wherever you found them. Everything else (browsing and claiming, editing items, purchases, relationships, admin) stays on the web.
The server side is ready either way: everything the app talks to is the mobile API that ships with your deployment. That surface is gated behind the enableMobileApp admin toggle and is off by default, so a deployment that has no use for it is already closed.
A Look at It
Section titled “A Look at It”
Screenshots follow the site theme. More of the web UI is on the Screenshots page.
What It Does Today
Section titled “What It Does Today”-
Sign in per device. Enter your server’s host, your email and password, and a name for the device. The server mints a per-device API key for that install (see API Keys (Mobile App)); TOTP, passkey, and OIDC sign-in are all supported. Revoking one device from Settings → Account → Devices doesn’t sign the user out elsewhere.
-
Save workflow. The Save tab turns a link, a product, a photo, or just a title into an item on one of your writable lists. Every route ends on the same save form, which starts on your primary list; pick another list there if it belongs somewhere else.
- Paste or type a link - the server scrapes the title, photo, and price for review before saving.
- Scan a barcode - point the camera at a UPC, EAN, or GTIN. When barcode lookup is turned on server-side, the scan prefills the title, brand, photo, and a candidate URL. If more than one product matches, the form lists the matches so you can pick one. With lookup off, the Save tab doesn’t offer the scanner at all. When the server takes photos (see below) and a barcode finds nothing, the scanner stays open and offers Take a Photo Instead: point it at the product and it saves the item from a photo. It offers the same after a few seconds without finding a barcode.
- Snap a photo - take a picture or choose one from your library. With object storage set up, the photo becomes the item’s image. With Photo to Item on, the server also looks at the photo and fills in the title and price for you to check before saving. The Save tab offers photos when the server can do either; when it can only identify photos, the photo fills in the details but isn’t kept.
- Type it in - no link, just a title, for things you can’t point at a web page.
- Share from any other app - the share extension sends a URL in from Safari, a retailer app, or Messages, and drops you into the same save form without opening the app.
-
Home screen widgets. Three widgets surface who and what is coming up without launching the app:
- Coming Up - birthdays and holidays together, soonest first, looking 90 days ahead. Small, medium, and large home screen sizes plus Lock Screen. It has no settings of its own.
- Upcoming Birthdays - the next few birthdays, with a heads-up on anyone you haven’t shopped for recently.
- Upcoming Holidays - the next few holidays configured on your server.
Birthdays and Holidays come in small and medium home screen sizes plus Lock Screen, and each is configurable for how far ahead it looks. All three work in StandBy and follow the system’s tinted and vibrant rendering modes.
-
See upcoming holidays and birthdays. The Upcoming tab combines birthdays and holidays into one feed, grouped into This Week, then by month out to 90 days, then the next holiday beyond that. Each birthday is marked Needs a Gift or Gift Lined Up, with when you last picked a gift for them. Chips at the top narrow the feed to people who need a gift, birthdays only, or holidays only.
-
App icon badge. Optionally, the app icon can carry a count of what’s coming up. Under Settings → App Icon Badge, choose what it counts (birthdays you haven’t shopped for, all birthdays, holidays, or birthdays and holidays) and how far ahead it looks, from today up to 60 days. It’s off by default and stored on the device only.
Enabling It on a Self-Hosted Deployment
Section titled “Enabling It on a Self-Hosted Deployment”- In Admin Settings, turn on
enableMobileApp. This exposes the mobile API surface and the per-user API-key UI. See Admin Settings for context. - Have each user install the app and sign in with your server’s host, their email and password, and a device name. The key is minted for that device automatically - nothing to copy and paste.
- Optional: to enable adding items by barcode, turn on barcode lookup at
/admin/barcode. It’s off by default, and until it’s on the app doesn’t offer the scanner. - Optional: to enable adding items from a photo, set up object storage so photos are kept as item images, and an AI provider with Photo to Item on so the app can identify what’s in them. Either one is enough for the app to offer photos.