Help

Support

Common questions, plus an email at the bottom. One inbox reads everything.

Getting started

First-launch flow and how a session works.

How do I start my first session?
  1. Pick a mode in the row above the Lock In button: Flow, Focus, Deep, or one you've made yourself.
  2. Tap Lock In.
  3. The session begins. Any apps you've configured for that mode disappear behind the iOS shield until the timer ends.

If the mode you picked has app blocking configured, iOS will ask for Screen Time permission the first time. Approve to start; decline to run the session as a timer only.

Where do notifications come from?

Locally. awaymode schedules them through Apple's UserNotifications framework the moment a session starts, so they fire even if the app is backgrounded or force-quit. For chained modes like Focus, every phase boundary gets its own alert: "break time" at each work-end, "back to it" at each break-end, and "done. time's yours." when the chain finishes.

What happens if I force-quit awaymode during a session?

Nothing bad. awaymode writes the session state to disk at every transition. When you reopen the app it picks up where you left off, and the Screen Time shield stays up the whole time. Force-quitting does not end a session.

Can I run awaymode on iPad?

Not in v1. iPhone only for now. iPad is on the v2 roadmap.

App blocking

Screen Time integration and strict mode.

Why does awaymode ask for Screen Time access?

Because the blocking is done by iOS, not by awaymode. Apple's FamilyControls framework powers Screen Time, and awaymode uses it to shield the apps you flagged. Without permission awaymode still runs a timer. It just can't block.

The framework is built for privacy: awaymode sees opaque tokens, not app names. We can't read which apps are on your phone.

How do I select what to block?
  1. Open Settings → Modes in awaymode.
  2. Tap the mode you want to configure.
  3. Tap Block apps.
  4. iOS presents its Screen Time picker. Pick apps or categories and tap Done.

Each mode keeps its own selection. Focus can shield social media while Deep shields everything but your editor.

I picked a category. Why does it count as 1?

Apple doesn't tell us how many apps live inside a category. Categories are opaque tokens for privacy. iOS still shields every app in the category at the OS level; we just can't show you the count. Tap the "X blocked" pill above Lock In to see the actual selection awaymode is holding.

What's special about Deep mode?

Deep is strict. Once started, the end-session button is disabled and the shield holds until the timer runs out. Other modes let you end early via a confirmation. Use Deep when you genuinely want the option to bail removed.

Can I get around the strict shield?

Not from inside awaymode. The shield is enforced by iOS. You could uninstall the app, but iOS keeps Screen Time restrictions briefly after uninstall, and your session record is permanently lost. The polite answer: don't start a strict session unless you mean it.

Can awaymode block itself?

No. We strip awaymode's own app token from any selection at picker close and at session start. Apple's picker shows every installed app including the host, so without this safeguard a user could accidentally shield awaymode mid-session and lock themselves out of the app that ends the session.

Modes

What are the built-in modes?
  • Flow. One 10-minute block, no chain. The between-meetings option. Free.
  • Focus. Classic pomodoro chain. 25 min work, 5 min rest, four rounds. 115 min wall-clock total. Free.
  • Deep. One 90-minute strict block. No early end. Pro.
How do I create a custom mode?
  1. On the Timer screen, scroll the modes row to the end and tap +.
  2. Or open Settings → Modes and tap the + in the section header.
  3. Set the name, duration, cycles, break length, icon, strict toggle, and app selection. Tap Save.

Custom modes appear alongside the built-ins and can be reordered, edited, or deleted from Settings → Modes. Custom modes are Pro.

The Focus timer shows 25 min. Why not 115?

The on-screen countdown shows the current work block. The descriptor below ("4 rounds · 5 min rest" / "115 min wall clock") shows the full commitment. Notifications fire at every transition so you always know what round you're in.

History & data

Where does my session history live?

In Apple's SwiftData store, on your device. There is no awaymode server. There is no cloud copy. Uninstalling awaymode removes all session history and configuration permanently.

Can I sync across devices?

Not in v1. iCloud sync is on the roadmap; v1 keeps the data-handling surface deliberately small.

How do I export my history?

Export isn't in v1. If you need a way to move history off awaymode, email and we'll prioritise the feature based on demand.

How do I delete my data?

Delete awaymode from your iPhone. Session records, custom modes, Screen Time selection, and preferences all go with the app. There is no awaymode server-side copy.

Does awaymode write to Apple Health?

Only if you opt in. Toggle Health on under Settings → Health, and awaymode will write completed focus sessions to Apple Health as Mindful Minutes. The write is one-way. Revoke any time in iOS Settings → Privacy & Security → Health → awaymode.

Billing

What's free?

Flow and Focus run free. With full app and category blocking included. Pro adds the Deep strict mode, custom modes, Apple Health integration, and Siri/Shortcuts.

How are subscriptions billed?

Through your Apple ID. Monthly is $6.99/mo. Annual is $34.99/yr after a 7-day free trial. Both auto-renew unless cancelled at least 24 hours before the period ends. Lifetime is $89 one-time, no renewal.

How do I cancel?
  1. iOS Settings → tap your name at the top.
  2. Subscriptions → awaymode → Cancel Subscription.

awaymode doesn't manage subscription state directly; Apple handles all of it.

I bought lifetime. Will it transfer to a new iPhone?

Yes. On the new device, open the paywall and tap Restore. StoreKit detects your prior purchase under the same Apple ID and unlocks the app.

How do I request a refund?

Apple manages all refunds. Visit reportaproblem.apple.com, find the awaymode charge, and request a refund there. We have no access to your payment information and cannot process refunds directly.

Troubleshooting

The shield isn't blocking an app I selected.
  1. Confirm Screen Time permission. iOS Settings → awaymode → Screen Time should show Allow Family Controls on.
  2. End the current session and start a new one. The shield is applied at session start.
  3. Toggle iOS Screen Time off and back on (iOS Settings → Screen Time).
  4. Restart the iPhone. Screen Time wedges occasionally; a restart clears it.

If the issue persists, email us with your iOS version and iPhone model.

I said "Don't Allow" on the Screen Time prompt by mistake.

iOS only asks once. To re-enable, go to iOS Settings → Screen Time → toggle off, then on. Then return to awaymode and try Lock In again. The onboarding screen also shows a direct link to Settings when permission is denied.

Live Activity isn't showing on my Lock Screen.
  1. iOS Settings → Face ID & Passcode → ensure Lock Screen access for notifications is allowed.
  2. iOS Settings → awaymode → Live Activities. Toggle on.
  3. End the active session and start a new one. Live Activities are spawned at session start and don't retroactively attach.
I'm not getting notifications when sessions end.
  1. iOS Settings → Notifications → awaymode. Confirm Allow Notifications is on.
  2. If you denied the prompt on first launch, you'll need to enable it here manually.
  3. Force-quit and reopen awaymode to re-register the notification scheduler.
The widget isn't updating.

awaymode asks WidgetKit to refresh after every session state change, but iOS controls how often widget timelines actually run. If your widget is stuck, remove and re-add it from the Home Screen. That forces a fresh timeline.

Found a bug.

Email jemrsgn9@gmail.com with iOS version, iPhone model, and a description of what you were doing when it broke. Screenshots are gold. One person reads everything; expect a reply within a day or two.

Contact

One inbox, one human. Write to jemrsgn9@gmail.com for support, bug reports, refund questions, and anything else.