Skip to content
PAM

PAM Native Widgets

Terminal window
pam add widgets
pam doctor
(new Widgets())->update(
    'account-summary',
    new WidgetContent(
        title: 'Available balance',
        subtitle: 'Updated just now',
        value: '$1,284.00',
        deepLink: 'myapp://account',
    ),
    fn (bool $updated, ?string $error) => null,
);

Widgets publishes bounded shared state; WidgetContent defines title, subtitle, value, and route. Autolinking creates WidgetKit extension/shared entitlements and Android receiver/resources. iOS uses group.<application-id>.pam-native.

Widgets are snapshots, not a background PHP runtime. Prepare display state in the app, keep lock-screen-visible values small/non-sensitive, use stable widget identifiers, and route rich interaction back through validated named deep links.

WidgetsPluginProvider registers the Android/iOS extension contract.