Home Screen widgets

MyZeekr ships three Home Screen widgets so you don't have to open the app for the basics. Long-press anywhere empty on your iPhone Home Screen → tap the + in the top corner → search MyZeekr → pick a size.

Small (2×2)

Glance-only. Shows your car's name, battery percent, charging glyph, lock state, and a small hero image of your car. Tap it to open the app.

Medium (4×2)

Same info as Small, plus a row of four one-tap action buttons at the bottom: Lock or Unlock (whichever you need next), Climate on or off, Charge Port open, and Frunk. Each one fires the same command the in-app button does — no need to open the app first.

Large (4×4)

Everything Medium has, plus a big battery bar with your remaining range in km, the street address where your car is parked, when it last reported in, and a row showing your next scheduled departure when one is set.

Sentry red dot

All three widgets show a small red dot next to the battery percentage whenever Sentry is on — whether you turned it on yourself or Auto Sentry did. No dot means Sentry is off. Same indicator across every size so you always know at a glance.

The charging bolt colour code

Every MyZeekr surface uses the same colour language for the charging bolt so it always means the same thing:

1. 1Green — actively charging (current is flowing to the car).
2. 2White — charging complete (session finished at your set limit or full).
3. 3Blue — plugged in but the session is paused (BMS thermal taper, or you tapped Stop remotely; the car is connected but current isn't flowing).
4. 4Orange — charge port open but no cable connected yet.
5. 5Grey — port closed, nothing plugged in.

On the Small widget the bolt hides entirely in the grey state so it doesn't add visual noise when there's nothing to report. On Medium and Large widgets the charge-port button stays visible even when grey so you can tap it to open the port.

How fresh the numbers are

The widget keeps itself current three ways, without you opening the app:

1. 1Charging — instant. Charging notifications carry the new state with them, so the bolt and battery percentage flip the moment the notification arrives, even if the app is closed.
2. 2Everything else (lock, doors, climate, Sentry) — usually under a minute. Our server notices the change and asks iOS to wake MyZeekr briefly in the background for a fresh snapshot.
3. 3A quiet self-check every few minutes as backup. The widget fetches the latest state on its own refresh cycle, so it catches up even when iOS declines the background wake-ups.

If the widget looks a few minutes behind

That's iOS pacing background work, not the app misbehaving. iOS decides when wake-ups and widget redraws actually happen, and it budgets them per app. Three situations where you'll notice:

1. 1The first day or two after installing. iOS is cautious with new apps, so non-charging updates can lag 10-15 minutes at first. It learns quickly — after a couple of days of normal use, updates land in well under a minute.
2. 2Right after tapping a widget button. The command fires immediately — the icon just waits up to a minute for your car's cloud to confirm the new state rather than guessing.
3. 3Low Power Mode or a freshly restarted iPhone — background work resumes once things settle.

Worst case, the widget's own self-check brings it current within about 15 minutes. Charging state is the exception — that updates instantly with the notification. And opening the app always refreshes everything on the spot.

Keep MyZeekr running in the background

For widgets to stay fresh, iOS needs permission to wake MyZeekr in the background. Two things to check once, then forget:

1. 1Settings → General → Background App Refresh — the master toggle should be on, and MyZeekr in the list below should be on. Both are on by default when you install the app.
2. 2Try not to swipe MyZeekr up to force-quit it. iOS stops waking force-quit apps in the background, so most widget updates slow down to the self-check cycle. Charging updates still arrive instantly (they ride the notification), but lock, climate, and the rest will lag. If you swipe up by habit, a small MyZeekr paused banner drops from the top to remind you.

One iOS behavior we can't override: Low Power Mode (below 20% battery, or manually toggled) suspends background refresh for third-party apps. Widget will resume normal refresh cadence once Low Power Mode is off.