NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #5265 most downloaded on Packagist
Build fast native Android and iOS applications with PHP and PAM.
Latest stable
v1.54.3
Last release 3 days ago
19 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 months old
386 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Preserve independent CSS column-gap and row-gap values in flex and flex-wrap layouts. The retained Rust engine now applies the horizontal and vertical
column-gap and row-gap values in flex and
flex-wrap layouts. The retained Rust engine now applies the horizontal and
vertical axes independently during line breaking, placement and intrinsic
measurement, while gap remains the fallback for either omitted axis.Add an optional failure callback to PushNotifications::register() so FCM and APNs provider/configuration failures can recover application UI without t
PushNotifications::register() so FCM
and APNs provider/configuration failures can recover application UI without
throwing from an asynchronous native-module result. Existing positional API
and exception behavior remain compatible when no callback is supplied.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Add native baseline cross-axis alignment throughout the typed API, template renderer, scoped CSS utility compiler and Rust layout engine. Horizontal f
Match React Native text-input baselines on Android by disabling the platform font padding, and retry imperative scroll requests after the next rendere
Add bounded pressedScale feedback to Pressable on Android and iOS, compositing it with authored scaleX/scaleY transforms and the existing pressedOpaci
pressedScale feedback to Pressable on Android and iOS,
compositing it with authored scaleX/scaleY transforms and the existing
pressedOpacity animation. The declarative pressedScale attribute and
fluent Pressable::pressedScale() API preserve a scale of 1 by default.Add typed scrollTargetAlignment (start, center, or end) to tokenized descendant scroll requests on Android and iOS scroll views and virtualized lists.
scrollTargetAlignment (start, center, or end) to tokenized
descendant scroll requests on Android and iOS scroll views and virtualized
lists. Alignment accounts for target and viewport extent and clamps edge
targets without changing the existing start-aligned default.Add an optional failure callback to Location::current() so permission, provider and timeout failures can recover application UI without throwing from
Location::current() so permission,
provider and timeout failures can recover application UI without throwing
from an asynchronous native-module result. Existing positional parameters
and exception behavior remain compatible when no failure callback is given.Add authenticated, observable sandbox downloads through Files::downloadWithProgress(), including validated request headers, typed byte progress, expli
Files::downloadWithProgress(), including validated request headers, typed
byte progress, explicit failure callbacks and cancellation. The Android
implementation streams off the UI thread, enforces the existing 256 MiB
ceiling and atomically publishes only completed files.Files::open() and an app-private Android FileProvider, allowing a
downloaded sandbox document to open in a compatible platform application
without exposing file:// URIs or granting broad storage access.Files::download() with optional validated request headers and a
non-throwing failure callback while preserving its existing positional API.Add optional failure callbacks to Linking::open(), canOpen(), and initial() so applications can recover from asynchronous platform link failures witho
Linking::open(), canOpen(), and
initial() so applications can recover from asynchronous platform link
failures without an uncaught exception.Add optional failure callbacks to AudioRecorder::start(), stop(), cancel(), discard(), and watch() so applications can recover their UI from asynchron
AudioRecorder::start(), stop(),
cancel(), discard(), and watch() so applications can recover their UI
from asynchronous native recorder failures without an uncaught exception.Support tokenized scrollRequest, scrollTargetOffset, and scrollTargetTestId on Android and iOS virtualized lists, grids, and section lists, including
scrollRequest, scrollTargetOffset, and
scrollTargetTestId on Android and iOS virtualized lists, grids, and section
lists, including variable-height cells and offscreen targets.Route Android MediaPlayer HTTP and HTTPS sources through the network URL overload instead of ContentResolver, fixing remote audio/video failures repor
MediaPlayer HTTP and HTTPS sources through the network URL
overload instead of ContentResolver, fixing remote audio/video failures
reported as No content provider while preserving content://, file://
and android.resource:// playback.Preserve explicit reactive scrollRequest commands on Android instead of restoring the pre-commit viewport afterward, fixing jump-to-target and jump-to
scrollRequest commands on Android instead of
restoring the pre-commit viewport afterward, fixing jump-to-target and
jump-to-end controls that appeared to run but left the list in place.Treat Android and iOS file/media picker cancellation as normal UI control flow: Files::pick() now resolves null and Files::pickMany() resolves an empt
Files::pick() now resolves null and Files::pickMany() resolves an
empty list instead of raising a native-module failure when users press back.null through MediaCapture::capture() as
well, while preserving native failures for actual capture/import errors.Render Android MediaPlayer thumbnails as native posters and keep them visible until the first video frame reaches the TextureView, preventing blank me
MediaPlayer thumbnails as native posters and keep them
visible until the first video frame reaches the TextureView, preventing
blank media surfaces while remote playback prepares or buffers.Make declarative MediaPlayer autoPlay fully reactive on Android and iOS: switching the bound value to false now pauses a prepared player at its curren
MediaPlayer autoPlay fully reactive on Android and iOS:
switching the bound value to false now pauses a prepared player at its
current position instead of leaving native playback running.Match Android CameraRoll recent-media ordering by sorting equal added-time assets by modified time instead of media ID.
Make the Android renderer release artifact self-contained for SDK assembly by shipping its matching Cargo workspace and Rust engine/protocol sources.
Add the typed BorderStyle/borderStyle protocol contract with solid, dashed, and dotted values.
BorderStyle/borderStyle protocol contract with solid,
dashed, and dotted values.border-style and render uniform patterned borders
natively on Android and iOS, including rounded corners and image hosts.Fix Image/ImageBackground cachePolicy="none" so templates map it to a typed native policy instead of throwing Unknown template option none.
Image/ImageBackground cachePolicy="none" so templates map it to a
typed native policy instead of throwing Unknown template option none.Paint the active declarative StatusBar color over the Android 15+ edge-to-edge status-bar inset, so a light root view cannot show through a dark autho
StatusBar color over the Android 15+
edge-to-edge status-bar inset, so a light root view cannot show through a
dark authored system-bar surface.Reapply the active declarative StatusBar configuration after host-root background synchronization on Android 15 and newer, so a status-bar color diffe
StatusBar configuration after host-root
background synchronization on Android 15 and newer, so a status-bar color
different from the screen root is not overwritten at the end of a render
commit.Decode declarative MediaPlayer progress payloads and invoke template handlers with the documented (float $currentTime, float $duration) pair, matching
MediaPlayer progress payloads and invoke template
handlers with the documented (float $currentTime, float $duration) pair,
matching the programmatic component API instead of passing one wire string.StatusBar omits navigationBarHidden, preventing retained routes from
overriding the active global navigation-bar contract.Add Android immersive navigation control through StatusBar::navigationBarHidden() and the declarative navigationBarHidden property, including transien
StatusBar::navigationBarHidden() and the declarative
navigationBarHidden property, including transient swipe recovery and
safe-area inset updates when system navigation is hidden.StatusBar color, icon appearance, visibility and
translucency to active Android modal windows, so full-screen modal routes no
longer retain the dialog theme's light system bar.Add bounded, atomic Files::download() support on Android and iOS for materializing HTTPS media into the PAM sandbox as a typed FileReference.
Files::download() support on Android and iOS for
materializing HTTPS media into the PAM sandbox as a typed FileReference.Canonicalize the Android file-sandbox root before deriving returned relative paths, preventing /data/user/0 and /data/data aliases from producing a tr
/data/user/0 and /data/data aliases from producing a
traversal-shaped FileReference after Files::copyAsset().Add Files::copyAsset() for atomically materializing packaged project assets in the application file sandbox without transporting base64 bytes through
Files::copyAsset() for atomically materializing packaged project assets
in the application file sandbox without transporting base64 bytes through
PHP, with traversal protection and Android/iOS implementations.Add bounded, normalized positioned text-layer compositing to ImageEditor::render(), including scale, radian rotation, color and integer presentation s
ImageEditor::render(), including scale, radian rotation, color and integer
presentation style for editable social-media compositions.Decode explicitly passed $event expression arguments into GestureEvent when the target method uses that type, enabling contextual handlers such as mov
$event expression arguments into GestureEvent
when the target method uses that type, enabling contextual handlers such as
moveLayer($id, $event) without exposing the binary wire payload.Reject malformed p-for directives during template compilation instead of deferring the deterministic failure until the component renders on-device.
p-for directives during template compilation instead of
deferring the deterministic failure until the component renders on-device.GestureDetector trees resolve to exactly one
child across conditional branches, while accepting complete mutually
exclusive p-if/p-else-if/p-else chains.Measure dialog-modal cards at their authored percentage or fixed width and intrinsic content height in the shared layout engine, then center the resul
Reveal the focused input automatically when padding-mode Android keyboard avoidance owns a contained vertical scroll view.
keyboardVerticalOffset as extra
space for adjacent form actions, with API 26–36 instrumentation coverage.Normalize declarative ScrollView deceleration aliases so normal and fast encode as numeric protocol values accepted by both native hosts.
ScrollView deceleration aliases so normal and
fast encode as numeric protocol values accepted by both native hosts.0...1 range
and cover alias and numeric behavior with PHP SDK regressions.Add Sms::isAvailable() and Sms::compose() for querying platform support and opening a pre-addressed native SMS draft without sending automatically.
Sms::isAvailable() and Sms::compose() for querying platform support
and opening a pre-addressed native SMS draft without sending automatically.ACTION_SENDTO with the smsto: scheme so only
messaging applications can handle the request, declare the corresponding
Android package-visibility query, and use MessageUI's native composer on iOS.Preserve an Android dialog modal's intrinsic card width and height and center it inside the native backdrop instead of stretching every dialog child t
Promote the remaining replacement route when a renderer update removes the currently active Android route after a completed pop. This prevents a valid
Idle after native transition
completion instead of leaving a settled pop encoded in later renders.Preserve a subpixel safety guard for intrinsic text measured from packaged TTF/OTF advances. This prevents Android TextView from wrapping a final word
TextView from wrapping a final word
into a clipped second line when platform hinting rounds the run fractionally
wider than the font's ideal advance sum.Expose the device's IANA time-zone identifier through DeviceInfo::timeZone on Android and iOS so applications can format API timestamps in local time.
DeviceInfo::timeZone
on Android and iOS so applications can format API timestamps in local time.DeviceInfo values
with a documented UTC fallback when older native hosts omit the field.Honor dark status-bar icons on Android 15 and newer instead of silently forcing light icons after the platform's edge-to-edge transition.
disabled template attributes to the inverse native
enabled state so controls stop interaction and report their state correctly
to accessibility services.Nothing published for this version
Add production plugin manifests for typed IDL fingerprints, Swift Package dependencies, Apple frameworks, purpose strings, app entitlements, Info.plis
NFCReaderUsageDescription key in validated plugin metadata.Add Laravel-inspired named route stacks, tabs, screens and modals. Components navigate through their nearest application scope without receiving a Nav
Navigator, and class-based screens hydrate typed constructor parameters.AsyncResource and
Suspense APIs; add deterministic bounded numeric PNW1 worklet bytecode.Clear process-local linking, incoming-share, and push subscriptions during runtime shutdown so hot reload can rebuild an app without duplicate-listene
Make Android activity and transparent full-screen modal windows share one explicit edge-to-edge contract, including stable system-bar/display-cutout i
Complete the 17-block native navigation parity program: route identity, layered options, typed actions and bubbling, recursive state, auth guards, lin
Introduce Navigation Core 2 with typed actions, interceptable lifecycle events, recursive navigation state, exact-route preloading, dynamic options, c
Establish one explicit Android edge-to-edge window contract before mounting the PAM host, avoiding OEM-dependent decor fitting on Samsung devices.
SafeAreaView and early DeviceInfo
queries, preventing transient zero bottom insets during cold start.Router::restoreState(false) for applications that require a
deterministic initial route without deleting persisted domain state or
briefly mounting a historical navigation stack.Resolve Android safe areas from stable system-bar and display-cutout insets, including transient gesture/button navigation bars and early runtime devi
GestureDetector for pan, pinch and
rotation. High-refresh-rate media viewers can now follow the display cadence
without dispatching a PHP event or committing a render tree on every frame.on:change handlers with bind:value updates so input
masks and validators observe the freshly bound value instead of being
silently replaced by the model callback.Added a public, package-restricted Android background-push broadcast contract to the plugin API. Plugins can now handle FCM data-only messages while t
dev.pam.nativeapp.action.PUSH_RECEIVED.Add an explicit pure-function allowlist to restricted template expressions for trim, ltrim, rtrim, byte/multibyte length, substring, and casing helper
trim, ltrim, rtrim, byte/multibyte length, substring, and casing
helpers.eval, while preserving public component-method calls.Resolve safe-area padding against the system-bar space already consumed by Android's decor-fitted content frame. SafeAreaView no longer applies the st
SafeAreaView no longer applies the
status or navigation inset twice on Android versions and OEM windows that do
not run edge-to-edge.Snap Android layout edges in the absolute physical-pixel grid, deriving each rendered extent from its rounded start and end edges instead of rounding
Measure intrinsic text with the actual packaged TTF/OTF face selected by @font-face, eliminating clipped labels and font-specific centering drift.
@font-face, eliminating clipped labels and font-specific centering drift.Calibrate intrinsic text widths against Android sans-serif glyph advances instead of reserving broad per-run safety space.
Preserve inherited CSS typography across compiled component boundaries through an internal style context, while keeping those values out of typed cons
color, font, line-height, alignment, letter spacing, or text case..pam.php component with regression tests.Add PHP-compatible, right-associative ?? null coalescing to restricted PAM template expressions, including safe missing and nested array/property path
?? null coalescing to restricted PAM
template expressions, including safe missing and nested array/property paths.eval.Accept Expo Image's familiar cachePolicy="memory-disk" and camel-case memoryDisk spellings as aliases for PAM's native memory-plus-disk force-cache po
cachePolicy="memory-disk" and camel-case
memoryDisk spellings as aliases for PAM's native memory-plus-disk
force-cache policy on Image and ImageBackground.Accept keyboardType="default" and the familiar React Native keyboard names (email-address, number-pad, numeric, phone-pad, decimal-pad, and text-keybo
keyboardType="default" and the familiar React Native keyboard names
(email-address, number-pad, numeric, phone-pad, decimal-pad, and
text-keyboard variants) as aliases for PAM's typed native keyboard modes.Accept the standard CSS text-align: left and text-align: right values as aliases for PAM's direction-aware start and end alignment. Existing templates
text-align: left and text-align: right values as
aliases for PAM's direction-aware start and end alignment. Existing
templates keep their behavior, while web-style component CSS no longer
fails during mount.Position absolute flex children with automatic insets from their CSS static position. align-items/align-self and justify-content now center or trail b
align-items/align-self and justify-content now center or
trail badges, tab indicators, logo layers, and other absolute adornments
without app-specific offsets.