Drop-in mock for Apple’s DeclaredAgeRange API — works on simulator and older iOS versions.

A hybrid compatibility wrapper and mock framework for Apple’s DeclaredAgeRange API.
It allows developers to build, test, and run apps that depend on Apple’s age-gating framework — even on Simulators, older iOS versions, and VisionOS, while automatically using the real system API when available.

Apple introduced DeclaredAgeRange to enforce age gating under US privacy law.
However, it’s not available on Simulators, older OS versions, or VisionOS.
That makes local testing and CI workflows painful.

✅ AgeRangeKit fixes that.

• Works in production and development.
• Fallback mock behavior for unsupported devices.
• Seamless switch to the Apple API when available.
• UI for DOB entry, sharing preferences, and parental control simulation.

In Xcode:

File → Add Packages → https://github.com/muthuselvam/AgeRangeKit.git

Or add this to your Package.swift:

.package(url: "https://github.com/muthuselvam/AgeRangeKit.git", from: "1.0.0")

Add to your Podfile:

pod 'AgeRangeKit', :git => 'https://github.com/muthuselvam/AgeRangeKit.git'

Then run:

pod install

import AgeRangeKit

do {
    let response = try await AgeRangeService.shared.requestAgeRange(ageGates: 13, 15, 18, in: window)
    switch response {
    case .sharing(let range):
        print("User is \(range.lowerBound ?? 0)+ years old")
    case .declinedSharing:
        print("User declined to share their age range.")
    }
} catch {
    print("Error requesting age range: \(error)")
}

let mock = MockAgeRangeProvider(initialScenario: .sharingTeen)
let service = AgeRangeService(mock)
let response = try await service.requestAgeRange(ageGates: 13, in: window)

AgeRangeKit also supports the SwiftUI @Environment pattern:

@Environment(\.requestAgeRange) var requestAgeRange

Button("Check Age") {
    Task {
        let response = try await requestAgeRange(13, 15, 18, window)
        print(response)
    }
}

MIT License © 2025 Muthu L