pushinbr/pam-native-widgets

Android App Widgets and iOS WidgetKit timelines for PAM Native.

Maintainers

Package info

github.com/push-in/pam-native-widgets

Language:Swift

Type:pam-native-plugin

pkg:composer/pushinbr/pam-native-widgets

Transparency log

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.1.0 2026-08-01 03:52 UTC

Requires

BUSL-1.1 d59e5a563838ad344ebc67005eb165dd9753c078

Published on Packagist.org on 2026-08-01 06:05 UTC

This package is auto-updated.

Last update: 2026-08-01 06:14:32 UTC

README

Updates Android App Widgets and iOS WidgetKit timelines from PHP through process-safe shared storage. Widget content is intentionally bounded; use deep links to open rich application screens.

iOS uses group.<application-id>.pam-native, shared by the generated app and widget targets. Widgets are not a background PHP runtime: prepare their display model in the app, then call Widgets::update().

Install

composer require pushinbr/pam-native-widgets
pam mobile prepare

Autolinking creates the WidgetKit extension, shared entitlements, Android receiver, resources, and native bridge.

Publish widget state

use Pam\Native\Widgets\WidgetContent;
use Pam\Native\Widgets\Widgets;

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

Keep widget values small and non-sensitive because they can appear while the device is locked. The identifier is stable application metadata, not a per-device widget instance ID.