Skip to content

iOS App

The app lives in the ios/ repo and is built from source in Xcode. A public distribution is on the roadmap but not dated.

If you’re self-hosting and comfortable with Xcode, you can sideload it against your own server today. The setup steps live in the iOS repo README.

  • Sign in per device. Each install authenticates via a per-device API key minted from the user’s account settings (see API Keys (Mobile App)). Revoking one device doesn’t sign the user out elsewhere.
  • Save from anywhere. A share extension lets you send a URL into the app from any other app (Safari, a retailer app, Messages) and queues it as an item with a scraped preview.
  • Compose items on the go. Type an item directly, or use the quick-add by barcode flow to scan a product’s UPC, EAN, or GTIN. When a barcode provider is configured server-side, the scan prefills the title, brand, photo, and a candidate URL for review before save.
  • See upcoming holidays and birthdays. A dedicated view lists the next holidays and dependent birthdays so you can plan ahead from your phone.
  • Home screen widgets. Pin GiftWrapt to your home screen with widgets that surface upcoming holidays and birthdays at a glance, no app launch required.
  1. In Admin Settings, turn on enableMobileApp. This exposes the mobile API surface and the per-user API-key UI. See Admin Settings for context.
  2. Have each user mint a device API key from their account settings page and paste it into the iOS app’s login screen alongside the server URL.
  3. Optional: to enable the quick-add by barcode flow, configure a lookup provider at /admin/barcode. Without a provider, the app hides the scanner button.