Offline SDK Mode

AppActor SDKs expose cached and offline-friendly reads so your app can behave sensibly when the network is unreliable.

What can be cached

Depending on platform, the SDK can expose:

cached offerings
cached remote configs
cached customer info
offline entitlement keys
fallback offerings bundled with the app

How to use it

Use cached state for fast UI and resilience. Use fresh reads when you need to confirm current access, recover purchases, or debug account state.

Important distinction

Cached state can keep the app usable, but it is not the same as fresh server-confirmed state. If support, account recovery, or billing correctness matters, trigger the explicit refresh or recovery path.

Read precedence

When the app asks for customer state, think in this order:

Fresh server response with trusted verification.
Signed cache or 304-validated state when the server confirms nothing changed.
Transient stale cache if the network is temporarily unavailable.
Offline-derived entitlement keys from trusted local store state.
No access if none of the above can prove an active entitlement.

Use the lower levels for UX continuity. Use the top levels for support, backend access, or high-value unlocks.

Safe offline pattern

final cached = await AppActor.instance.getCachedCustomerInfo();
if (cached.hasActiveEntitlement('premium')) {
  showPremiumShell();
}

try {
  final fresh = await AppActor.instance.getCustomerInfo();
  updatePremiumState(fresh.hasActiveEntitlement('premium'));
} catch (_) {
  final offlineKeys = await AppActor.instance.activeEntitlementKeysOffline();
  updatePremiumState(offlineKeys.contains('premium'));
}

const cached = await AppActor.instance.getCachedCustomerInfo();
if (cached.hasActiveEntitlement('premium')) {
  showPremiumShell();
}

try {
  const fresh = await AppActor.instance.getCustomerInfo();
  updatePremiumState(fresh.hasActiveEntitlement('premium'));
} catch {
  const offlineKeys = await AppActor.instance.activeEntitlementKeysOffline();
  updatePremiumState(offlineKeys.has('premium'));
}

For strict access, combine offline state with Trusted Entitlements and Server-side Access Checks.

Overview

Get Started

Testing and Go Live

Features

Remote Config

Experiments

Platform Resources

AI-Ready

What can be cached

How to use it

Important distinction

Read precedence

Safe offline pattern

​What can be cached

​How to use it

​Important distinction

​Read precedence

​Safe offline pattern

What can be cached

How to use it

Important distinction

Read precedence

Safe offline pattern