expo-app-blocker 0.1.48 → 0.1.49

package/README.md

@@ -255,6 +255,10 @@ The `SYSTEM_ALERT_WINDOW` overlay flashed on top of a blocked app is fully theme
 | `overlayIconSize` | `number` (dp) | `96` | Square icon edge length. Only renders when `android.overlay.icon` was declared in the plugin config (build-time). |
 | `overlayIconBottomMargin` | `number` (dp) | `20` | Vertical gap between the icon and the title. |
 | `overlayTitleBottomMargin` | `number` (dp) | `12` | Vertical gap between the title and the body text. |
+| `overlayShowSpinner` | `boolean` | `false` | Render an indeterminate Material circular spinner below the body text — same shape RN's `<ActivityIndicator>` produces. Useful as a "launching…" cue during the brief gap between intercept and the deep-link landing. |
+| `overlaySpinnerSize` | `number` (dp) | `32` | Spinner edge length (square). Only used when `overlayShowSpinner` is true. |
+| `overlaySpinnerTopMargin` | `number` (dp) | `24` | Vertical gap between the body text and the spinner. |
+| `overlaySpinnerColor` | `string` (hex) | system primary | Tints the spinner. Useful to match your brand color. |
 | `notificationTitle` | `string` | `"App Blocked"` | Foreground-service notification title. |
 | `notificationText` | `string` | `"{appName} is blocked. Tap to manage."` | Foreground-service notification body. |
 

package/android/src/main/java/expo/modules/appblocker/AppBlockerPrefs.kt

@@ -18,6 +18,10 @@ object AppBlockerPrefs {
   private const val KEY_OVERLAY_ICON_SIZE = "overlay_icon_size"
   private const val KEY_OVERLAY_ICON_GAP = "overlay_icon_gap"
   private const val KEY_OVERLAY_TITLE_GAP = "overlay_title_gap"
+  private const val KEY_OVERLAY_SHOW_SPINNER = "overlay_show_spinner"
+  private const val KEY_OVERLAY_SPINNER_SIZE = "overlay_spinner_size"
+  private const val KEY_OVERLAY_SPINNER_GAP = "overlay_spinner_gap"
+  private const val KEY_OVERLAY_SPINNER_COLOR = "overlay_spinner_color"
   private const val KEY_NOTIFICATION_TITLE = "notification_title"
   private const val KEY_NOTIFICATION_TEXT = "notification_text"
 
@@ -54,6 +58,10 @@ object AppBlockerPrefs {
     overlayIconSize: Float?,
     overlayIconBottomMargin: Float?,
     overlayTitleBottomMargin: Float?,
+    overlayShowSpinner: Boolean?,
+    overlaySpinnerSize: Float?,
+    overlaySpinnerTopMargin: Float?,
+    overlaySpinnerColor: String?,
     notificationTitle: String?,
     notificationText: String?,
   ) {
@@ -63,6 +71,7 @@ object AppBlockerPrefs {
       .putString(KEY_OVERLAY_BG_COLOR, overlayBackgroundColor)
       .putString(KEY_OVERLAY_TITLE_COLOR, overlayTitleColor)
       .putString(KEY_OVERLAY_TEXT_COLOR, overlayTextColor)
+      .putString(KEY_OVERLAY_SPINNER_COLOR, overlaySpinnerColor)
       .putString(KEY_NOTIFICATION_TITLE, notificationTitle)
       .putString(KEY_NOTIFICATION_TEXT, notificationText)
     putNullableFloat(editor, KEY_OVERLAY_TITLE_FONT_SIZE, overlayTitleFontSize)
@@ -71,11 +80,18 @@ object AppBlockerPrefs {
     putNullableFloat(editor, KEY_OVERLAY_ICON_SIZE, overlayIconSize)
     putNullableFloat(editor, KEY_OVERLAY_ICON_GAP, overlayIconBottomMargin)
     putNullableFloat(editor, KEY_OVERLAY_TITLE_GAP, overlayTitleBottomMargin)
+    putNullableFloat(editor, KEY_OVERLAY_SPINNER_SIZE, overlaySpinnerSize)
+    putNullableFloat(editor, KEY_OVERLAY_SPINNER_GAP, overlaySpinnerTopMargin)
     if (overlayTitleBold != null) {
       editor.putBoolean(KEY_OVERLAY_TITLE_BOLD, overlayTitleBold)
     } else {
       editor.remove(KEY_OVERLAY_TITLE_BOLD)
     }
+    if (overlayShowSpinner != null) {
+      editor.putBoolean(KEY_OVERLAY_SHOW_SPINNER, overlayShowSpinner)
+    } else {
+      editor.remove(KEY_OVERLAY_SHOW_SPINNER)
+    }
     editor.apply()
   }
 
@@ -115,6 +131,18 @@ object AppBlockerPrefs {
   fun getOverlayTitleBottomMargin(context: Context): Float =
     getOverlayFloat(context, KEY_OVERLAY_TITLE_GAP, 12f)
 
+  fun getOverlayShowSpinner(context: Context): Boolean =
+    get(context).getBoolean(KEY_OVERLAY_SHOW_SPINNER, false)
+
+  fun getOverlaySpinnerSize(context: Context): Float =
+    getOverlayFloat(context, KEY_OVERLAY_SPINNER_SIZE, 32f)
+
+  fun getOverlaySpinnerTopMargin(context: Context): Float =
+    getOverlayFloat(context, KEY_OVERLAY_SPINNER_GAP, 24f)
+
+  fun getOverlaySpinnerColor(context: Context): String? =
+    get(context).getString(KEY_OVERLAY_SPINNER_COLOR, null)
+
   fun getNotificationTitle(context: Context): String =
     get(context).getString(KEY_NOTIFICATION_TITLE, null) ?: "App Blocked"
 

package/android/src/main/java/expo/modules/appblocker/ExpoAppBlockerModule.kt

@@ -84,6 +84,10 @@ class ExpoAppBlockerModule : Module() {
         overlayIconSize = numberOrNull("overlayIconSize"),
         overlayIconBottomMargin = numberOrNull("overlayIconBottomMargin"),
         overlayTitleBottomMargin = numberOrNull("overlayTitleBottomMargin"),
+        overlayShowSpinner = config["overlayShowSpinner"] as? Boolean,
+        overlaySpinnerSize = numberOrNull("overlaySpinnerSize"),
+        overlaySpinnerTopMargin = numberOrNull("overlaySpinnerTopMargin"),
+        overlaySpinnerColor = config["overlaySpinnerColor"] as? String,
         notificationTitle = config["notificationTitle"] as? String,
         notificationText = config["notificationText"] as? String,
       )

package/android/src/main/java/expo/modules/appblocker/OverlayManager.kt

@@ -15,6 +15,7 @@ import android.view.View
 import android.view.WindowManager
 import android.widget.ImageView
 import android.widget.LinearLayout
+import android.widget.ProgressBar
 import android.widget.TextView
 
 class OverlayManager(private val context: Context) {
@@ -183,6 +184,25 @@ class OverlayManager(private val context: Context) {
         setTextSize(TypedValue.COMPLEX_UNIT_SP, textFontSize)
         gravity = Gravity.CENTER
       })
+
+      // Optional indeterminate spinner — gives the user a visual cue that
+      // the app is launching during the ~150–300ms gap between intercept
+      // detection and the deep-link landing.
+      if (AppBlockerPrefs.getOverlayShowSpinner(context)) {
+        val spinnerSize = dp(AppBlockerPrefs.getOverlaySpinnerSize(context))
+        val spinnerGap = dp(AppBlockerPrefs.getOverlaySpinnerTopMargin(context))
+        addView(ProgressBar(context).apply {
+          isIndeterminate = true
+          val tint = AppBlockerPrefs.getOverlaySpinnerColor(context)
+          if (tint != null) {
+            val parsed = parseColorOrNull(tint)
+            if (parsed != null) indeterminateTintList = android.content.res.ColorStateList.valueOf(parsed)
+          }
+          layoutParams = LinearLayout.LayoutParams(spinnerSize, spinnerSize).apply {
+            topMargin = spinnerGap
+          }
+        })
+      }
     }
   }
 
@@ -192,6 +212,12 @@ class OverlayManager(private val context: Context) {
     fallback
   }
 
+  private fun parseColorOrNull(hex: String): Int? = try {
+    Color.parseColor(hex)
+  } catch (_: IllegalArgumentException) {
+    null
+  }
+
   private fun buildLayoutParams(): WindowManager.LayoutParams {
     @Suppress("DEPRECATION")
     val type = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-app-blocker",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "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",

package/src/ExpoAppBlocker.types.ts

@@ -173,6 +173,14 @@ export interface AndroidConfig {
   overlayIconBottomMargin?: number;
   /** Vertical gap (dp) between the title and the body text. Default: 12. */
   overlayTitleBottomMargin?: number;
+  /** Show an indeterminate circular spinner under the body text. Useful as a "launching…" cue during the brief gap between intercept and the deep-link landing. Default: false. */
+  overlayShowSpinner?: boolean;
+  /** Spinner edge length in dp (square). Default: 32. */
+  overlaySpinnerSize?: number;
+  /** Vertical gap (dp) between the body text and the spinner. Default: 24. */
+  overlaySpinnerTopMargin?: number;
+  /** Hex color (e.g. "#7cb518") tinting the spinner. Default: system primary. */
+  overlaySpinnerColor?: string;
   /** Notification title when app is blocked. Use {appName} as placeholder. Default: "App Blocked" */
   notificationTitle?: string;
   /** Notification text when app is blocked. Use {appName} as placeholder. */