iOS recording stops when screen locks
**This is a current limitation of the iOS app**, not a bug. Recording stops if the screen locks because the current build doesn't yet use a background audio session category that survives screen lock.
**The workaround (today):**
1. iPhone Settings → Display & Brightness → Auto-Lock
2. Set to **Never** while you're using VoicePad
3. Keep the screen on during dictation
4. Change back to your preferred timeout when done
Or briefly tap the screen every few minutes to reset the auto-lock timer.
**Why this happens:**
iOS apps have to declare in their `Info.plist` that they need background audio. Even with the declaration, the audio session must be configured to use a category that allows background recording. The current iOS build uses `playAndRecord` but doesn't fully configure for screen-lock survival.
**The fix is on the roadmap.**
This is a known issue and a high-priority fix. The fix requires:
- Updating `AVAudioSession` to category `.record` with `.allowBluetooth` and `.mixWithOthers` options
- Adding background-audio entitlement (already declared)
- Testing across iOS 15, 16, 17, 18
Track progress on the public roadmap at [voicepad-tech.productlift.dev/t/roadmap](https://voicepad-tech.productlift.dev/t/roadmap) — search for "background dictation."
**Workarounds for now:**
- **Quick dictations under 1 minute:** screen lock won't trigger if you finish before auto-lock
- **Use Auto-Lock = Never temporarily**
- **Use the Apple Watch** when it's available (will support lock-screen-survival from launch)
**Related iOS limitations to know:**
- VoicePad Orb not available on iOS in v2.1.0 (Android-only for now)
- USB sync not available on iOS (use WiFi sync)
- Voice commands not available on iOS (Android-only)
All of these are in active development — see the public roadmap for status.