mobile

name	Mobile
description	Build mobile applications with proper lifecycle handling, offline support, and platform conventions.
metadata	{"clawdbot":{"emoji":"📱","os":["linux","darwin","win32"]}}

Lifecycle Awareness

• App can be killed anytime in background—save state before backgrounding
• Restore state on return—user expects to continue where they left off
• Handle low memory warnings—release caches, non-essential resources
• Background tasks have time limits—complete or request extension

Permissions

• Ask in context, not at launch—explain why when requesting
• Degrade gracefully if denied—app should still work with reduced features
• Don't ask for unnecessary permissions—users notice and distrust
• Re-request after demonstrating value—not immediately after denial

Offline First

• Assume network is unreliable—design for offline, sync when possible
• Cache aggressively—previous content better than loading spinner
• Queue actions for retry—don't fail on network error
• Conflict resolution strategy—last write wins or manual merge
• Show sync status—user should know if data is current

Performance

• Target 60fps—dropped frames feel janky
• Main thread for UI only—heavy work on background threads
• Memory matters more than desktop—constrained devices, aggressive OS killing
• Battery awareness—reduce location polling, network requests when possible
• Startup time under 2 seconds—first impression matters

Navigation Patterns

• Follow platform conventions—iOS back gesture, Android back button
• Navigation stack manageable—don't go 10 levels deep
• Deep link to any screen—shareable, notification taps work
• Preserve scroll position on return—don't jump to top

Notifications

• Push for time-sensitive external events—new message, delivery update
• Local for reminders, timers—user-initiated
• Don't spam—users will disable; quality over quantity
• Actionable when possible—reply, mark done from notification
• Group related notifications—less intrusive

Deep Linking

• Universal Links (iOS) / App Links (Android) for owned domains
• Handle gracefully when app not installed—fallback to web
• Parse parameters safely—malicious links exist
• Test all entry points—not just main launch

Storage

• Secure storage for tokens, credentials—Keychain, Keystore
• User data survives reinstall where appropriate—cloud backup
• Cache is cache—can be cleared; don't store critical data
• Large files: consider on-demand download—not bundled in app

Input Handling

• Keyboard avoidance—content shifts to stay visible
• Dismiss keyboard appropriately—tap outside, scroll, submit
• Input accessories for relevant actions—next field, done, toolbar
• Paste, autofill support—reduce typing on small keyboards

Touch and Gestures

• 44pt minimum touch target—consistent with platform guidelines
• System gestures reserved—don't override swipe from edge
• Gesture discoverability—hint or teach, don't assume knowledge
• Haptic feedback for significant actions—confirmation, errors

Accessibility

• VoiceOver (iOS) / TalkBack (Android) testing—navigate entire app
• Dynamic type support—text scales with user preference
• Sufficient contrast—check in accessibility inspector
• Labels on all interactive elements—not just visible text

Testing

• Real devices essential—simulators miss performance, sensors, edge cases
• Multiple OS versions—support at least current minus 2
• Different screen sizes—small phones to tablets
• Network conditions—slow, intermittent, offline

App Store Survival

• Read rejection reasons before submitting—common pitfalls documented
• Privacy policy required—explain data collection
• Login test account for reviewers—if auth required
• No placeholder content—everything functional in review build
• Update regularly—abandoned apps get deprioritized