Setting up the iOS companion app
Last updated About 5 hours ago
The WorkCalmly iOS companion app lets you block distracting apps on your iPhone during focus sessions.
What it does
The companion app connects to WorkCalmly and blocks the apps you choose whenever a focus session is active. It uses iOS's built-in Screen Time API to enforce blocking — no manual effort needed once it's set up.
How to set it up
Download the WorkCalmly app from the App Store.
In WorkCalmly (web app), go to Settings > App Blocker and generate your QR code. You can also find this during onboarding.
Open the companion app on your iPhone and scan the QR code to link it to your account.
Grant Screen Time access when prompted. This is what allows the app to block other apps.
Grant Notification access when prompted. Sending notifications is necessary so WorkCalmly can tell your phone what to do. They’re silent. They won’t make a sound or vibrate.
Select the apps you want to block during focus sessions.
That's it. The next time you start a focus session, your selected apps will be blocked automatically.
Troubleshooting
QR code isn't scanning. Make sure your phone camera has enough light and hold it steady. You can also try regenerating the QR code in Settings > Distraction Blockers.
Blocking status didn’t update. If this happens, the connection between WorkCalmly and your Phone got interrupted. Try to start & stop a focus session. If the blocking status isn’t fixed then you can go to the app’s settings and use the Emergency Unblock.
Blocking stopped mid-session. Once a session is active, blocking should stay in place until it ends. If it stopped early, Low Power Mode may have interfered. Disable it in Settings > Battery, then open the companion app to restore the connection.
Was this helpful?
Still need help? Share an idea