Skip to main content

Troubleshooting

"Family Controls authorization required"​

The user must grant Family Controls permission before any blocking features work. Use requestScreenTimePermissionsAsync() to prompt for authorization.

Extensions not appearing​

  1. Ensure "expo-screen-time" is in your plugins array
  2. Run npx expo prebuild --clean to regenerate native code
  3. Check that your ios.bundleIdentifier and ios.appleTeamId are set
  4. If filtering targets, confirm the extension is listed in expo.extra.expoScreenTime.targets

Shield configuration not applying​

The ShieldConfigurationExtension must be included in your targets. Check your expo.extra.expoScreenTime.targets configuration if you're filtering targets.

Schedule monitoring not working​

The DeviceActivityMonitorExtension must be included. Monitor events fire when the device is first used after the schedule time (not exactly at the scheduled time).

Running the example app​

See the example/ directory for a complete app demonstrating all features:

cd example
bun install   # postinstall builds the plugin (../plugin/build) and symlinks the module
bun run ios

The config plugin loads from the gitignored plugin/build. The example's postinstall runs the root bun run build for you; if you build the module manually, run bun run build at the repo root before expo prebuild.