Skip to content

iOS App

The app is a separate codebase from the server and is built from source in Xcode. Its repository is not public yet, and there is no App Store distribution, so the sections below describe what the app does rather than how to get it. Both are on the roadmap without a date.

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.

  • 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.