expo-app-blocker 0.1.1 → 0.1.3

package/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    # Skip version bump commits to prevent loops
+    if: "!startsWith(github.event.head_commit.message, 'v')"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Determine version bump
+        id: version
+        run: |
+          COMMIT_MSG="${{ github.event.head_commit.message }}"
+          if echo "$COMMIT_MSG" | grep -qw "\[major\]"; then
+            echo "bump=major" >> $GITHUB_OUTPUT
+          elif echo "$COMMIT_MSG" | grep -qw "\[minor\]"; then
+            echo "bump=minor" >> $GITHUB_OUTPUT
+          else
+            echo "bump=patch" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Bump version (no git commit)
+        run: npm version ${{ steps.version.outputs.bump }} --no-git-tag-version
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Output version
+        run: echo "Published $(node -p 'require("./package.json").version')"

package/README.md

@@ -22,6 +22,8 @@ Cross-platform app blocking module for Expo. Block other apps and redirect users
 
 ### Apple Developer Portal (iOS)
 
+> **Full step-by-step guide**: [docs/APPLE_DEVELOPER_SETUP.md](docs/APPLE_DEVELOPER_SETUP.md)
+
 1. Register **4 App IDs** with **Family Controls** and **App Groups** capabilities:
    - `com.yourapp.id` (main app)
    - `com.yourapp.id.DeviceActivityMonitor`
@@ -85,13 +87,18 @@ Add the plugin to your `app.json`:
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `ios.appGroup` | `string` | Required | App Group identifier for shared data |
-| `ios.shield.title` | `string` | `"Hold on!"` | Shield overlay title |
-| `ios.shield.subtitle` | `string` | `"{appName} is blocked."` | Shield subtitle. `{appName}` is replaced with the blocked app name |
+| `ios.shield.title` | `string` | `"Hold on!"` | Shield title. `{appName}` replaced with blocked app name |
+| `ios.shield.titleColor` | `string` | `"#111111"` | Title text color (hex) |
+| `ios.shield.subtitle` | `string` | `"{appName} is blocked."` | Shield subtitle. `{appName}` replaced with blocked app name |
+| `ios.shield.subtitleColor` | `string` | `"#8c8c8c"` | Subtitle text color (hex) |
 | `ios.shield.primaryButtonLabel` | `string` | `"Earn Free Time"` | Primary button text |
+| `ios.shield.primaryButtonLabelColor` | `string` | `"#ffffff"` | Primary button text color (hex) |
+| `ios.shield.primaryButtonBackgroundColor` | `string` | `"#7cb518"` | Primary button background color (hex) |
 | `ios.shield.secondaryButtonLabel` | `string\|null` | `"Not now"` | Secondary button text. Set to `null` to hide |
-| `ios.shield.primaryButtonColor` | `string` | `"#7cb518"` | Primary button background color (hex) |
-| `ios.shield.backgroundBlurStyle` | `string` | `"systemThickMaterial"` | iOS blur style |
-| `ios.shield.icon` | `string` | SF Symbol | Path to custom shield icon PNG (relative to project root, e.g. `"./assets/shield-icon.png"`) |
+| `ios.shield.secondaryButtonLabelColor` | `string` | `"#8c8c8c"` | Secondary button text color (hex) |
+| `ios.shield.backgroundColor` | `string\|null` | `null` | Background tint color over blur (hex, supports alpha e.g. `"#FF000033"`) |
+| `ios.shield.backgroundBlurStyle` | `string` | `"systemThickMaterial"` | Blur style. Options: `extraLight`, `light`, `dark`, `regular`, `prominent`, `systemUltraThinMaterial`, `systemThinMaterial`, `systemMaterial`, `systemThickMaterial`, `systemChromeMaterial`, and light/dark forced variants |
+| `ios.shield.icon` | `string` | SF Symbol | Path to custom shield icon PNG (relative to project root) |
 | `android.notificationTitle` | `string` | `"App Blocked"` | Notification title |
 | `android.notificationText` | `string` | `"{appName} is blocked."` | Notification text |
 

package/docs/APPLE_DEVELOPER_SETUP.md

@@ -0,0 +1,161 @@
+# Apple Developer Portal Setup
+
+This guide walks you through the one-time setup required in the Apple Developer Portal for `expo-app-blocker` on iOS.
+
+## Prerequisites
+
+- A **paid Apple Developer account** ($99/year)
+- Access to https://developer.apple.com/account
+
+---
+
+## Step 1: Create the App Group
+
+The App Group enables data sharing between your main app and the three iOS extensions.
+
+1. Go to **Identifiers**: https://developer.apple.com/account/resources/identifiers/list
+2. Change the dropdown from **"App IDs"** to **"App Groups"**
+   - Or go directly to: https://developer.apple.com/account/resources/identifiers/list/applicationGroup
+3. Click the **+** (blue plus) button
+4. Select **App Groups** > **Continue**
+5. Fill in:
+   - **Description**: `Your App Name Shared` (e.g., "My App Blocker Shared")
+   - **Identifier**: The value you set in `ios.appGroup` in your plugin config
+     - Example: `group.com.yourapp.blocker`
+6. Click **Continue** > **Register**
+
+---
+
+## Step 2: Register the Main App ID
+
+1. Go to **Identifiers**: https://developer.apple.com/account/resources/identifiers/list
+2. Make sure the dropdown shows **"App IDs"**
+3. Click the **+** button
+4. Select **App IDs** > **Continue**
+5. Select **App** > **Continue**
+6. Fill in:
+   - **Description**: Your app name (e.g., "My App Blocker")
+   - **Bundle ID**: Select **Explicit**, enter your `ios.bundleIdentifier` from `app.json`
+     - Example: `com.yourapp.id`
+7. Scroll down to **Capabilities** and enable:
+   - **App Groups**
+   - **Family Controls**
+8. Click **Continue** > **Register**
+
+> **Note on Family Controls**: If you don't see Family Controls in the capabilities list, you may need to request it. Look for a link to request additional capabilities, or check if it appears under "Additional Capabilities".
+
+---
+
+## Step 3: Register the DeviceActivityMonitor Extension App ID
+
+1. Click the **+** button again
+2. **App IDs** > **App** > **Continue**
+3. Fill in:
+   - **Description**: `Your App DeviceActivityMonitor`
+   - **Bundle ID**: Explicit, enter `{your-bundle-id}.DeviceActivityMonitor`
+     - Example: `com.yourapp.id.DeviceActivityMonitor`
+4. Enable capabilities:
+   - **App Groups**
+   - **Family Controls**
+5. Click **Continue** > **Register**
+
+---
+
+## Step 4: Register the ShieldAction Extension App ID
+
+1. Click the **+** button
+2. **App IDs** > **App** > **Continue**
+3. Fill in:
+   - **Description**: `Your App ShieldAction`
+   - **Bundle ID**: Explicit, enter `{your-bundle-id}.ShieldAction`
+     - Example: `com.yourapp.id.ShieldAction`
+4. Enable capabilities:
+   - **App Groups**
+   - **Family Controls**
+5. Click **Continue** > **Register**
+
+---
+
+## Step 5: Register the ShieldConfiguration Extension App ID
+
+1. Click the **+** button
+2. **App IDs** > **App** > **Continue**
+3. Fill in:
+   - **Description**: `Your App ShieldConfiguration`
+   - **Bundle ID**: Explicit, enter `{your-bundle-id}.ShieldConfiguration`
+     - Example: `com.yourapp.id.ShieldConfiguration`
+4. Enable capabilities:
+   - **App Groups**
+   - **Family Controls**
+5. Click **Continue** > **Register**
+
+---
+
+## Step 6: Assign the App Group to All App IDs
+
+For **each of the 4 App IDs** you just created:
+
+1. Click on the App ID in the list
+2. Scroll to **App Groups**
+3. Click **Configure** (or **Edit**)
+4. Check your App Group (e.g., `group.com.yourapp.blocker`)
+5. Click **Save**
+
+Repeat for all 4:
+- `com.yourapp.id`
+- `com.yourapp.id.DeviceActivityMonitor`
+- `com.yourapp.id.ShieldAction`
+- `com.yourapp.id.ShieldConfiguration`
+
+---
+
+## Summary Checklist
+
+When you're done, you should have:
+
+- [ ] **1 App Group**: `group.com.yourapp.blocker`
+- [ ] **4 App IDs**, each with Family Controls + App Groups:
+
+| App ID | Description |
+|---|---|
+| `com.yourapp.id` | Main app |
+| `com.yourapp.id.DeviceActivityMonitor` | Relock timer extension |
+| `com.yourapp.id.ShieldAction` | Shield button handler extension |
+| `com.yourapp.id.ShieldConfiguration` | Custom shield UI extension |
+
+- [ ] App Group assigned to all 4 App IDs
+
+---
+
+## About Family Controls Approval
+
+- **Development builds** (run from Xcode): Family Controls works **without** formal Apple approval
+- **TestFlight**: May require approval depending on your account
+- **App Store**: Requires Family Controls capability approval from Apple
+
+To request approval:
+1. Go to https://developer.apple.com/contact/request/family-controls-distribution
+2. Fill out the form explaining your app's use case
+3. Wait for Apple's response (can take days to weeks)
+
+**You can develop and test locally without waiting for approval.**
+
+---
+
+## Troubleshooting
+
+**"Family Controls" not visible in capabilities list**
+- Make sure you're on a paid developer account (not free)
+- Try searching for it in the capabilities search bar
+- You may need to request access: https://developer.apple.com/contact/request/family-controls-distribution
+
+**"An App ID with this identifier is not available"**
+- The bundle ID might already be registered. Check your existing identifiers.
+
+**App Group not showing when configuring an App ID**
+- Make sure you created the App Group first (Step 1)
+- Try refreshing the page
+
+**Signing errors in Xcode after setup**
+- In Xcode: select each target > Signing & Capabilities > set your Team
+- Xcode should automatically create provisioning profiles using the registered App IDs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-app-blocker",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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/plugin/src/index.js

@@ -141,7 +141,23 @@ function withAppBlockerIOS(config, pluginConfig) {
         }
       }
 
-      // Inject app group into extension Swift files
+      // Inject config values into extension Swift files
+      const shield = pluginConfig?.ios?.shield || {};
+      const replacements = {
+        "APP_GROUP_PLACEHOLDER": appGroup,
+        "SHIELD_TITLE_PLACEHOLDER": shield.title || "Hold on!",
+        "SHIELD_TITLE_COLOR_PLACEHOLDER": shield.titleColor || "#111111",
+        "SHIELD_SUBTITLE_PLACEHOLDER": shield.subtitle || "{appName} is blocked.",
+        "SHIELD_SUBTITLE_COLOR_PLACEHOLDER": shield.subtitleColor || "#8c8c8c",
+        "SHIELD_PRIMARY_LABEL_PLACEHOLDER": shield.primaryButtonLabel || "Earn Free Time",
+        "SHIELD_PRIMARY_LABEL_COLOR_PLACEHOLDER": shield.primaryButtonLabelColor || "#ffffff",
+        "SHIELD_PRIMARY_BG_COLOR_PLACEHOLDER": shield.primaryButtonBackgroundColor || shield.primaryButtonColor || "#7cb518",
+        "SHIELD_SECONDARY_LABEL_PLACEHOLDER": shield.secondaryButtonLabel === null ? "NONE" : (shield.secondaryButtonLabel || "Not now"),
+        "SHIELD_SECONDARY_LABEL_COLOR_PLACEHOLDER": shield.secondaryButtonLabelColor || "#8c8c8c",
+        "SHIELD_BG_COLOR_PLACEHOLDER": shield.backgroundColor || "NONE",
+        "SHIELD_BLUR_STYLE_PLACEHOLDER": shield.backgroundBlurStyle || "systemThickMaterial",
+      };
+
       const targetsDir = path.join(path.dirname(platformRoot), "targets");
       if (fs.existsSync(targetsDir)) {
         const dirs = fs.readdirSync(targetsDir);
@@ -153,16 +169,20 @@ function withAppBlockerIOS(config, pluginConfig) {
             if (!file.endsWith(".swift")) continue;
             const filePath = path.join(dirPath, file);
             let content = fs.readFileSync(filePath, "utf-8");
-            if (content.includes("APP_GROUP_PLACEHOLDER")) {
-              content = content.replace(/APP_GROUP_PLACEHOLDER/g, appGroup);
-              fs.writeFileSync(filePath, content);
+            let changed = false;
+            for (const [placeholder, value] of Object.entries(replacements)) {
+              if (content.includes(placeholder)) {
+                content = content.replace(new RegExp(placeholder, "g"), value);
+                changed = true;
+              }
             }
+            if (changed) fs.writeFileSync(filePath, content);
           }
         }
       }
 
       // Copy shield icon to ShieldConfiguration target assets
-      const shieldIcon = pluginConfig?.ios?.shield?.icon;
+      const shieldIcon = shield.icon;
       if (shieldIcon) {
         const projectRoot = path.dirname(platformRoot);
         const iconSrc = path.resolve(projectRoot, shieldIcon);

package/src/ExpoAppBlocker.types.ts

@@ -66,21 +66,39 @@ export interface RelockResult {
 // ──────────────────────────────────────────────────────────────────────────────
 
 export interface ShieldConfig {
-  /** Title shown on the shield. Use {appName} as placeholder. Default: "Hold on!" */
+  /** Title text. Use {appName} as placeholder for the blocked app name. Default: "Hold on!" */
   title?: string;
-  /** Subtitle shown on the shield. Use {appName} as placeholder. */
+  /** Title text color (hex). Default: "#111111" */
+  titleColor?: string;
+  /** Subtitle text. Use {appName} as placeholder. Default: "{appName} is blocked." */
   subtitle?: string;
-  /** Primary button label. Default: "Earn Free Time" */
+  /** Subtitle text color (hex). Default: "#8c8c8c" */
+  subtitleColor?: string;
+  /** Primary button label text. Default: "Earn Free Time" */
   primaryButtonLabel?: string;
-  /** Secondary button label. Set to null to hide. Default: "Not now" */
-  secondaryButtonLabel?: string | null;
+  /** Primary button label text color (hex). Default: "#ffffff" */
+  primaryButtonLabelColor?: string;
   /** Primary button background color (hex). Default: "#7cb518" */
-  primaryButtonColor?: string;
-  /** Background color (hex). Default: null (uses blur) */
+  primaryButtonBackgroundColor?: string;
+  /** Secondary button label text. Set to null to hide the button. Default: "Not now" */
+  secondaryButtonLabel?: string | null;
+  /** Secondary button label text color (hex). Default: "#8c8c8c" */
+  secondaryButtonLabelColor?: string;
+  /**
+   * Background tint color (hex, supports alpha e.g. "#FF000033").
+   * Applied as overlay on top of the blur. Default: null (no tint)
+   */
   backgroundColor?: string | null;
-  /** Background blur style. Default: "systemThickMaterial" */
+  /**
+   * Background blur style. Default: "systemThickMaterial"
+   *
+   * Options: "extraLight", "light", "dark", "regular", "prominent",
+   * "systemUltraThinMaterial", "systemThinMaterial", "systemMaterial",
+   * "systemThickMaterial", "systemChromeMaterial",
+   * and light/dark forced variants (e.g. "systemMaterialDark")
+   */
   backgroundBlurStyle?: string;
-  /** Path to shield icon image. Optional. */
+  /** Path to custom shield icon PNG (relative to project root). Optional. */
   icon?: string;
 }
 

package/targets/ShieldConfiguration/ShieldConfigurationExtension.swift

@@ -6,15 +6,71 @@ class ShieldConfigurationExtension: ShieldConfigurationDataSource {
 
   private let appGroupIdentifier = "APP_GROUP_PLACEHOLDER"
 
-  // Grandmizer design system colors
-  private let primaryGreen = UIColor(red: 0.486, green: 0.710, blue: 0.094, alpha: 1.0) // #7cb518
-  private let darkGreen = UIColor(red: 0.361, green: 0.502, blue: 0.004, alpha: 1.0)    // #5c8001
-  private let accentOrange = UIColor(red: 0.984, green: 0.380, blue: 0.027, alpha: 1.0) // #fb6107
-  private let darkText = UIColor(red: 0.067, green: 0.067, blue: 0.067, alpha: 1.0)     // #111111
-  private let subtitleGray = UIColor(red: 0.45, green: 0.45, blue: 0.45, alpha: 1.0)
+  // ── Configurable values (injected by plugin at prebuild) ──────────────
+  private let cfgTitle = "SHIELD_TITLE_PLACEHOLDER"                           // default: "Hold on!"
+  private let cfgTitleColor = "SHIELD_TITLE_COLOR_PLACEHOLDER"                // default: "#111111"
+  private let cfgSubtitle = "SHIELD_SUBTITLE_PLACEHOLDER"                     // default: "{appName} is blocked."
+  private let cfgSubtitleColor = "SHIELD_SUBTITLE_COLOR_PLACEHOLDER"          // default: "#8c8c8c"
+  private let cfgPrimaryLabel = "SHIELD_PRIMARY_LABEL_PLACEHOLDER"            // default: "Earn Free Time"
+  private let cfgPrimaryLabelColor = "SHIELD_PRIMARY_LABEL_COLOR_PLACEHOLDER" // default: "#ffffff"
+  private let cfgPrimaryBgColor = "SHIELD_PRIMARY_BG_COLOR_PLACEHOLDER"       // default: "#7cb518"
+  private let cfgSecondaryLabel = "SHIELD_SECONDARY_LABEL_PLACEHOLDER"        // default: "Not now", "NONE" to hide
+  private let cfgSecondaryLabelColor = "SHIELD_SECONDARY_LABEL_COLOR_PLACEHOLDER" // default: "#8c8c8c"
+  private let cfgBgColor = "SHIELD_BG_COLOR_PLACEHOLDER"                      // default: "NONE" (no tint)
+  private let cfgBlurStyle = "SHIELD_BLUR_STYLE_PLACEHOLDER"                  // default: "systemThickMaterial"
+
+  // ── Helpers ───────────────────────────────────────────────────────────
+
+  private func hexColor(_ hex: String) -> UIColor {
+    var h = hex.trimmingCharacters(in: .whitespacesAndNewlines)
+    if h.hasPrefix("#") { h.removeFirst() }
+
+    var rgb: UInt64 = 0
+    Scanner(string: h).scanHexInt64(&rgb)
+
+    if h.count == 8 { // RRGGBBAA
+      return UIColor(
+        red: CGFloat((rgb >> 24) & 0xFF) / 255,
+        green: CGFloat((rgb >> 16) & 0xFF) / 255,
+        blue: CGFloat((rgb >> 8) & 0xFF) / 255,
+        alpha: CGFloat(rgb & 0xFF) / 255
+      )
+    }
+    return UIColor(
+      red: CGFloat((rgb >> 16) & 0xFF) / 255,
+      green: CGFloat((rgb >> 8) & 0xFF) / 255,
+      blue: CGFloat(rgb & 0xFF) / 255,
+      alpha: 1.0
+    )
+  }
+
+  private func resolveBlurStyle(_ name: String) -> UIBlurEffect.Style {
+    switch name {
+    case "extraLight": return .extraLight
+    case "light": return .light
+    case "dark": return .dark
+    case "regular": return .regular
+    case "prominent": return .prominent
+    case "systemUltraThinMaterial": return .systemUltraThinMaterial
+    case "systemThinMaterial": return .systemThinMaterial
+    case "systemMaterial": return .systemMaterial
+    case "systemThickMaterial": return .systemThickMaterial
+    case "systemChromeMaterial": return .systemChromeMaterial
+    case "systemUltraThinMaterialLight": return .systemUltraThinMaterialLight
+    case "systemThinMaterialLight": return .systemThinMaterialLight
+    case "systemMaterialLight": return .systemMaterialLight
+    case "systemThickMaterialLight": return .systemThickMaterialLight
+    case "systemChromeMaterialLight": return .systemChromeMaterialLight
+    case "systemUltraThinMaterialDark": return .systemUltraThinMaterialDark
+    case "systemThinMaterialDark": return .systemThinMaterialDark
+    case "systemMaterialDark": return .systemMaterialDark
+    case "systemThickMaterialDark": return .systemThickMaterialDark
+    case "systemChromeMaterialDark": return .systemChromeMaterialDark
+    default: return .systemThickMaterial
+    }
+  }
 
   private var mascotIcon: UIImage? {
-    // Load from the extension's own bundle
     let bundle = Bundle(for: type(of: self))
     return UIImage(named: "shield-icon", in: bundle, compatibleWith: nil)
       ?? UIImage(contentsOfFile: bundle.path(forResource: "shield-icon", ofType: "png") ?? "")
@@ -23,130 +79,68 @@ class ShieldConfigurationExtension: ShieldConfigurationDataSource {
   private func getBlockedAppCount() -> Int {
     guard let defaults = UserDefaults(suiteName: appGroupIdentifier) else { return 0 }
     guard let config = defaults.dictionary(forKey: "appBlocker.blockConfiguration.v1") else { return 0 }
-    if let items = config["blockedItems"] as? [[String: Any]] {
-      return items.count
-    }
+    if let items = config["blockedItems"] as? [[String: Any]] { return items.count }
     return 0
   }
 
   private func isTemporarilyUnlocked() -> Bool {
     guard let defaults = UserDefaults(suiteName: appGroupIdentifier) else { return false }
-    guard let expiration = defaults.object(forKey: "appBlocker.temporaryUnlock.v1") as? Date else { return false }
-    return Date() < expiration
+    guard let exp = defaults.object(forKey: "appBlocker.temporaryUnlock.v1") as? Date else { return false }
+    return Date() < exp
   }
 
-  override func configuration(shielding application: Application) -> ShieldConfiguration {
-    let appName = application.localizedDisplayName ?? "This app"
-
-    // If temporarily unlocked, show a different message
+  private func buildConfig(appName: String) -> ShieldConfiguration {
     if isTemporarilyUnlocked() {
       return ShieldConfiguration(
-        backgroundBlurStyle: .systemThickMaterial,
-        backgroundColor: nil,
+        backgroundBlurStyle: resolveBlurStyle(cfgBlurStyle),
+        backgroundColor: cfgBgColor == "NONE" ? nil : hexColor(cfgBgColor),
         icon: mascotIcon,
-        title: ShieldConfiguration.Label(
-          text: "Almost there!",
-          color: darkText
-        ),
-        subtitle: ShieldConfiguration.Label(
-          text: "Your free time is loading. Try again in a moment.",
-          color: subtitleGray
-        ),
-        primaryButtonLabel: ShieldConfiguration.Label(
-          text: "OK",
-          color: .white
-        ),
-        primaryButtonBackgroundColor: primaryGreen,
+        title: ShieldConfiguration.Label(text: "Almost there!", color: hexColor(cfgTitleColor)),
+        subtitle: ShieldConfiguration.Label(text: "Your free time is loading. Try again in a moment.", color: hexColor(cfgSubtitleColor)),
+        primaryButtonLabel: ShieldConfiguration.Label(text: "OK", color: .white),
+        primaryButtonBackgroundColor: hexColor(cfgPrimaryBgColor),
         secondaryButtonLabel: nil
       )
     }
 
+    let title = cfgTitle.replacingOccurrences(of: "{appName}", with: appName)
+    let subtitle = cfgSubtitle.replacingOccurrences(of: "{appName}", with: appName)
     let count = getBlockedAppCount()
-    let contextLine = count > 1
-      ? "You have \(count) apps blocked. Stay focused!"
-      : "Stay focused! Take a quick quiz to earn free time."
+    let fullSubtitle = count > 1
+      ? "\(subtitle) You have \(count) apps blocked."
+      : subtitle
+
+    let secondaryLabel: ShieldConfiguration.Label? =
+      cfgSecondaryLabel == "NONE" ? nil :
+      ShieldConfiguration.Label(text: cfgSecondaryLabel, color: hexColor(cfgSecondaryLabelColor))
 
     return ShieldConfiguration(
-      backgroundBlurStyle: .systemThickMaterial,
-      backgroundColor: nil,
+      backgroundBlurStyle: resolveBlurStyle(cfgBlurStyle),
+      backgroundColor: cfgBgColor == "NONE" ? nil : hexColor(cfgBgColor),
       icon: mascotIcon,
-      title: ShieldConfiguration.Label(
-        text: "Hold on!",
-        color: darkText
-      ),
-      subtitle: ShieldConfiguration.Label(
-        text: "\(appName) is blocked. \(contextLine)",
-        color: subtitleGray
-      ),
-      primaryButtonLabel: ShieldConfiguration.Label(
-        text: "Earn Free Time",
-        color: .white
-      ),
-      primaryButtonBackgroundColor: accentOrange,
-      secondaryButtonLabel: ShieldConfiguration.Label(
-        text: "Not now",
-        color: subtitleGray
-      )
+      title: ShieldConfiguration.Label(text: title, color: hexColor(cfgTitleColor)),
+      subtitle: ShieldConfiguration.Label(text: fullSubtitle, color: hexColor(cfgSubtitleColor)),
+      primaryButtonLabel: ShieldConfiguration.Label(text: cfgPrimaryLabel, color: hexColor(cfgPrimaryLabelColor)),
+      primaryButtonBackgroundColor: hexColor(cfgPrimaryBgColor),
+      secondaryButtonLabel: secondaryLabel
     )
   }
 
-  override func configuration(shielding application: Application,
-                               in category: ActivityCategory) -> ShieldConfiguration {
-    let categoryName = category.localizedDisplayName ?? "This category"
+  // ── Overrides ─────────────────────────────────────────────────────────
 
-    return ShieldConfiguration(
-      backgroundBlurStyle: .systemThickMaterial,
-      backgroundColor: nil,
-      icon: mascotIcon,
-      title: ShieldConfiguration.Label(
-        text: "Hold on!",
-        color: darkText
-      ),
-      subtitle: ShieldConfiguration.Label(
-        text: "\(categoryName) is blocked. Take a quick quiz to earn free time!",
-        color: subtitleGray
-      ),
-      primaryButtonLabel: ShieldConfiguration.Label(
-        text: "Earn Free Time",
-        color: .white
-      ),
-      primaryButtonBackgroundColor: accentOrange,
-      secondaryButtonLabel: ShieldConfiguration.Label(
-        text: "Not now",
-        color: subtitleGray
-      )
-    )
+  override func configuration(shielding application: Application) -> ShieldConfiguration {
+    buildConfig(appName: application.localizedDisplayName ?? "This app")
   }
 
-  override func configuration(shielding webDomain: WebDomain) -> ShieldConfiguration {
-    let domain = webDomain.domain ?? "This website"
+  override func configuration(shielding application: Application, in category: ActivityCategory) -> ShieldConfiguration {
+    buildConfig(appName: category.localizedDisplayName ?? "This category")
+  }
 
-    return ShieldConfiguration(
-      backgroundBlurStyle: .systemThickMaterial,
-      backgroundColor: nil,
-      icon: mascotIcon,
-      title: ShieldConfiguration.Label(
-        text: "Hold on!",
-        color: darkText
-      ),
-      subtitle: ShieldConfiguration.Label(
-        text: "\(domain) is blocked. Take a quick quiz to earn free time!",
-        color: subtitleGray
-      ),
-      primaryButtonLabel: ShieldConfiguration.Label(
-        text: "Earn Free Time",
-        color: .white
-      ),
-      primaryButtonBackgroundColor: accentOrange,
-      secondaryButtonLabel: ShieldConfiguration.Label(
-        text: "Not now",
-        color: subtitleGray
-      )
-    )
+  override func configuration(shielding webDomain: WebDomain) -> ShieldConfiguration {
+    buildConfig(appName: webDomain.domain ?? "This website")
   }
 
-  override func configuration(shielding webDomain: WebDomain,
-                               in category: ActivityCategory) -> ShieldConfiguration {
-    return configuration(shielding: webDomain)
+  override func configuration(shielding webDomain: WebDomain, in category: ActivityCategory) -> ShieldConfiguration {
+    buildConfig(appName: webDomain.domain ?? "This website")
   }
 }

package/ios/ExpoAppBlocker.podspec

@@ -1,21 +0,0 @@
-require 'json'
-
-package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
-
-Pod::Spec.new do |s|
-  s.name           = 'ExpoAppBlocker'
-  s.version        = package['version']
-  s.summary        = package['description']
-  s.description    = package['description']
-  s.license        = package['license']
-  s.author         = package['author'] || 'expo-app-blocker contributors'
-  s.homepage       = package['homepage']
-  s.platforms      = { :ios => '16.0' }
-  s.swift_version  = '5.9'
-  s.source         = { git: '' }
-  s.static_framework = true
-
-  s.dependency 'ExpoModulesCore'
-
-  s.source_files = '**/*.{h,m,swift}'
-end

package/ios/ExpoAppBlockerConfig.swift

@@ -1,19 +0,0 @@
-import Foundation
-
-// This file provides default configuration values.
-// The actual values are injected by the config plugin at prebuild time
-// into a generated file in the app's ios directory.
-// If the generated file exists, its values override these defaults.
-
-public struct ExpoAppBlockerConfig {
-  // Override this in your app by creating a file with:
-  // let expoAppBlockerAppGroup = "group.com.yourapp.blocker"
-  public static var appGroupIdentifier: String {
-    // Try to read from UserDefaults (set by config plugin)
-    if let appGroup = UserDefaults.standard.string(forKey: "expo.appblocker.appGroup") {
-      return appGroup
-    }
-    // Fallback - should be overridden
-    return "group.expo.app-blocker"
-  }
-}