Skip to content

Keeping the app running

Because you install faBolus yourself (not from the App Store), it has an expiry date. This page explains why, and the quick routine to keep it working. Good news: it's almost all clicking.

Why it expires

The certificate that signs your app has a limited life:

Account The app keeps working for
Free Apple ID 7 days
Apple Developer Program ($99/yr) 1 year

When it expires, the icon stays on your Home Screen but the app won't open (or shows a signing error). Nothing is broken — it just needs re-installing.

The quick reinstall (about a minute)

  1. Plug your iPhone into the Mac.
  2. In Finder, open Documents → faBolus → faBolus and double-click faBolus.xcodeproj.
  3. Pick your iPhone in the device bar at the top and click ▶ Run (or press ⌘ + R).
  4. If the phone asks you to Trust the developer again, do so (Step 8).

That's it — the fresh install resets the clock. Your saved pump pairing stays put (it's stored securely on the phone), so you won't need the 6-digit code again.

Put a reminder on your calendar

On a free account, a weekly reminder saves you from finding an expired app right when you need it. On the paid program, once a year is plenty.

Getting the newest version of the app

When the project gets updates, refresh your copy with GitHub Desktop — no commands:

  1. Open GitHub Desktop.
  2. Pick TandemKit from the repository list (top-left), then click Fetch origin → Pull origin.
  3. Do the same for faBolus.
  4. Re-do Step 3b (./scripts/generate-project.sh) in case files were added, then open the project and Run.
Advanced: update from the Terminal (optional) 
cd ~/Documents/faBolus/TandemKit && git pull --recurse-submodules
cd ~/Documents/faBolus/faBolus && git pull
./scripts/generate-project.sh
open faBolus.xcodeproj

If a build ever fails right after updating, see Troubleshooting — the usual fixes are re-fetching the helper files and re-running ./scripts/generate-project.sh.

Updating the Garmin app

Rebuild and re-install it — see Add a Garmin. The Garmin app doesn't expire like the iOS app does; you only reinstall it to get changes.