Skip to Content
expo-screen-time

Introduction

App blocking, schedules, shields and usage reports for Expo and React Native, on iOS and Android, behind one API. On iOS the module wraps Apple's Screen Time APIs (FamilyControls, ManagedSettings, DeviceActivity). On Android, which has no Screen Time API, it ships its own enforcement engine.

How enforcement differs

iOS restrictions are enforced by the OS. On Android the engine is friction: a foreground service draws the shield, and the user can stop it from the system settings, which getEnforcementGaps() reports. Categories and web domains are iOS-only today — see Platform support.

Features

  • Permissions — one call site; the steps the user must allow come back as data (iOS: the Family Controls prompt; Android: the Settings toggles, one screen at a time)
  • App blocking — block the apps the user picks in the native picker, as a blocklist or an allowlist (categories and web domains: iOS)
  • Web domain blocking — block specific domains without user selection (iOS)
  • App Store restrictions — prevent app installation and removal (Android: a shield over the stores, the package installer and the uninstall dialog)
  • Schedule monitoring — time-based blocking and usage thresholds, with events
  • Shield customization — customize the blocking screen appearance
  • Shield actions — configure button behaviors (close, snooze, unblock, open app)
  • Earned time — usage-based temporary unlocks that re-lock automatically
  • Enforcement gaps — getEnforcementGaps() tells when an Android block was intended but not enforced
  • Usage reports — JSX-authored report templates rendered natively on both platforms (usage data never reaches JS)
  • Token labels — display app names and icons from opaque handles (category and domain labels: iOS)

Requirements

  • iOS 16.0+, and an Apple Developer account with the Family Controls capability
  • Android 7.0+ (API 24)
  • Expo SDK 54+ (CI runs SDK 58; SDK 54 to 57 are checked to build)
  • A development build — the module cannot run in Expo Go

Next steps

On this page