expo-app-blocker 0.1.23 → 0.1.25

package/README.md

@@ -13,12 +13,15 @@ https://github.com/user-attachments/assets/37f34797-6b92-40d5-911a-90c40e9ffaaa
 > **iOS requires Apple Developer Portal setup before building.** See [Prerequisites](#prerequisites) for details.
 
 > [!IMPORTANT]
-> **Submit your Family Controls distribution approval request now.** App Store distribution requires Apple approval per bundle ID — it can take days to weeks and you can't ship without it. [Request here](https://developer.apple.com/contact/request/family-controls-distribution) (you'll need to submit once per bundle ID — 4 total). You can develop and test locally without waiting.
+> **Submit your Family Controls distribution approval request now.** App Store distribution requires Apple approval per bundle ID — it can take days to weeks and you can't ship without it. [Request here](https://developer.apple.com/contact/request/family-controls-distribution) (you'll need to submit once per bundle ID — 4 total).
+>
+> **While waiting for approval**, use the **Family Controls (Development)** capability in Xcode instead of the standard "Family Controls" — it's marked "Development only" in Xcode's Signing & Capabilities tab and works without Apple's approval. Development builds with this entitlement are fully functional on device but cannot be submitted to TestFlight or the App Store.
 
 <details>
 <summary><strong>Table of Contents</strong></summary>
 
 - [Features](#features)
+- [Build Compatibility](#build-compatibility)
 - [Quick Start](#quick-start)
 - [Prerequisites](#prerequisites)
 - [Plugin Options](#plugin-options)
@@ -56,6 +59,23 @@ https://github.com/user-attachments/assets/37f34797-6b92-40d5-911a-90c40e9ffaaa
 - Automatic iOS extension target creation via `@bacons/apple-targets`
 - Full Expo Config Plugin - no manual native setup required
 
+## Build Compatibility
+
+| Build type | Supported | Notes |
+|---|---|---|
+| **Expo Go** | ❌ | Requires custom native modules — not available in Expo Go |
+| **Development build** (`expo-dev-client`) | ✅ | Fully supported — same setup as production |
+| **Local build** (`expo run:ios` / `expo run:android`) | ✅ | Fully supported |
+| **EAS Build** | ✅ | Fully supported — see [EAS Build config](#eas-build) |
+| **Production / App Store** | ✅ | Fully supported — iOS requires Apple approval first |
+
+**This plugin requires a development build or a production build.** If you're using Expo Go, you'll need to [create a development build](https://docs.expo.dev/develop/development-builds/introduction/) first:
+
+```bash
+npx expo install expo-dev-client
+npx expo run:ios --device    # or: eas build --profile development
+```
+
 ## Quick Start
 
 ### 1. Install
@@ -170,8 +190,9 @@ npx expo run:android         # Android works on emulator
 
 3. Assign the App Group to all 4 App IDs
 
-4. Request **Family Controls** capability approval (required for App Store/TestFlight — works in local dev builds without it)
+4. Request **Family Controls** capability approval (required for App Store/TestFlight distribution)
    - Submit the form **once per bundle ID** (4 total): [developer.apple.com/contact/request/family-controls-distribution](https://developer.apple.com/contact/request/family-controls-distribution)
+   - **While waiting for approval**: use **Family Controls (Development)** in Xcode's Signing & Capabilities tab — fully functional in dev builds, just not distributable
    - Incomplete capability setup causes cryptic provisioning errors — make sure all 4 App IDs have Family Controls + App Groups enabled
 
 ### Android

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-app-blocker",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Expo module for cross-platform app blocking. Android: UsageStatsManager + Overlay. iOS: Screen Time API (FamilyControls + ManagedSettings + DeviceActivity).",
   "main": "src/index.ts",
   "types": "src/index.ts",