Changelog

For changes prior to v3, see the v2 documentation.

3.3.5#

Released: May 19, 2026

What's Changed

Bail native:run on host PHP / nativephp.lock mismatch by @simonhamp in #125
Add support for nested meta-data inside android manifest components by @Mallon94 in #5
Default app version to DEBUG by @simonhamp in #128
Fix native:jump hang on Windows and harden port detection by @simonhamp in #126
Potential jump win fix by @shanerbaner82 in #136
Add video and audio MIME types to scheme handlers by @voicecode-bv in #137
Fix hot reload and HMR for persistent PHP runtime by @shanerbaner82 in #62
Ignore file URLs in DeepLinkRouter by @wojt-janowski in #106
Add meta-data support inside Android receiver components by @PrestaEdit in #132
Fix iOS extraction of emoji-named files (Livewire 4 ⚡️ components) by @simonhamp in #138
Fix Vite asset loading on Android emulator with Herd HTTPS by @simonhamp in #129
feat(ios): replace PHP iterator with rsync for app copy step by @benjam-es in #30

New Contributors

@wojt-janowski made their first contribution in #106
@PrestaEdit made their first contribution in #132

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.3.4...3.3.5

3.3.4#

Released: May 11, 2026

What's Changed

Restore PHP 8.3 support in composer.json by @simonhamp in #122
Track full PHP version in nativephp.lock by @simonhamp in #121

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.3.3...3.3.4

3.3.3#

Released: May 9, 2026

What's Changed

Include build number in Laravel bundle staleness check by @simonhamp in #117
Clear stale HTTP_* headers from $_SERVER between persistent PHP dispatches by @simonhamp in #119

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.3.2...3.3.3

3.3.2#

Released: May 8, 2026

What's Changed

Restore PHPBridge.kt API dropped in Jump merge (#111) by @shanerbaner82 in #120

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.3.1...3.3.2

3.3.1#

Released: May 8, 2026

What's Changed

Fix iOS Podfile pod injection corrupting START/END markers by @shanerbaner82 in #118

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.3.0...3.3.1

3.3.0#

Released: May 8, 2026

What's Changed

fix(ios): pass log message as NSLog argument, not format string by @bkuhl in #108
fix(ios): preserve URL percent-encoding through to PHP by @bkuhl in #93
Fix str_getcsv deprecation warning on PHP 8.4 by @voicecode-bv in #101
fix(ios): allow apps to override plugin Info.plist permission strings by @shanerbaner82 in #116
Fix iOS form POSTs reaching PHP with empty $_POST by @shanerbaner82 in #114
Jump: live dev preview over WebSocket bridge by @shanerbaner82 in #111

New Contributors

@voicecode-bv made their first contribution in #101

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.6...3.3.0

3.2.6#

Released: April 28, 2026

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.5...3.2.6

3.2.5#

Released: April 24, 2026

What's Changed

Fix cold-launch races in PHP runtime boot and Laravel extraction by @shanerbaner82 in #102

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.4...3.2.5

3.2.4#

Released: April 23, 2026

What's Changed

Fix empty Android POST body after navigating by @shanerbaner82 in #99
Fail the build when axios is missing (Inertia 3 compatibility) by @shanerbaner82 in #100

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.3...3.2.4

3.2.3#

Released: April 10, 2026

What's Changed

Move endroid/qr-code to require and exclude from app bundles by @shanerbaner82 in #90

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.2...3.2.3

3.2.2#

Released: April 4, 2026

What's Changed

Fix Android POST body delivery and $_POST population by @shanerbaner82 in #84

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.1...3.2.2

3.2.1#

Released: April 3, 2026

What's Changed

Add thread safety for background task execution and context-only bridge registration by @shanerbaner82 in #83

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.2.0...3.2.1

3.2.0#

Released: April 1, 2026

What's Changed

Move endroid/qr-code to dev dependency by @shanerbaner82 in #81
Fix: Stop overriding APP_ENV on Android by @shanerbaner82 in #80
Support optional BasicAuthentication for plugin Maven repositories by @shanerbaner82 in #79
Fix iOS auth dialog showing "NativePHP" instead of app name by @shanerbaner82 in #68
Fix stale POST data causing duplicate bridge calls + notification URL navigation by @shanerbaner82 in #66
Add ephemeral PHP runtime and push notification support by @shanerbaner82 in #82

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.1.1...3.2.0

3.1.1#

Released: March 23, 2026

What's Changed

Add native:debug command for mobile environment diagnostics by @simonhamp in #52
Remove accidental pptx entry from gitignore by @benjam-es in #54
Extract scheduler into plugin architecture by @shanerbaner82 in #56
Move PHP version and ICU tracking to config by @simonhamp in #53
Fix plugin pod dependencies missing on subsequent iOS builds by @shanerbaner82 in #50
Validate Android min SDK against floor and plugin requirements by @simonhamp in #51

New Contributors

@benjam-es made their first contribution in #54

Full Changelog: https://github.com/NativePHP/mobile-air/compare/3.1.0...3.1.1

v3.1 — Persistent Runtime & Performance#

New Features#

Persistent PHP Runtime — Laravel boots once and the kernel is reused across requests, yielding ~5-30ms response times vs ~200-300ms previously.
ZTS (Thread-Safe) PHP support enabling background queue workers
PHP Queue Worker — a dedicated background thread runs queued Laravel jobs off the main thread on both iOS and Android. Just set QUEUE_CONNECTION=database and dispatch jobs as normal. See Queues for details.
Binary caching — PHP binaries are cached in nativephp/binaries to avoid re-downloading on every build
Versions manifest — binary URLs fetched from versions.json instead of being hardcoded
Android 8+ support — minimum SDK lowered from Android 13 (API 33) to Android 8 (API 26), dramatically expanding device reach
PHP 8.3–8.5 support — NativePHP now detects your app's PHP version from composer.json and matches it automatically, with PHP 8.3 as the lowest supported version
ICU/Intl support on iOS — iOS now ships with full ICU support, enabling Filament and other packages that depend on the intl extension to work on both platforms
Configurable Android SDK versions — compile_sdk, min_sdk, and target_sdk in your config
Plugin multi-register — native:plugin:register discovers and registers multiple plugins in one pass
Unregistered plugin warnings during native:run
ios/i and android/a flags for the native:jump command

Improvements#

Static linking on Android for better performance and reliability
Plugin compilation during native:package builds
URL encoding preserved on Android redirects
Removed unused react/http and react/socket dependencies

Developer Experience#

Laravel Boost skill support (shoutout Pushpak!) LINK TO PRS

v3.0 — Plugin Architecture#

Plugin-based architecture — the framework is built around a modular plugin system
All core APIs shipped as plugins — Camera, Biometrics, Dialog, and more are all individual plugins
NativeServiceProvider for registering third-party plugins
Plugin management commands — install, register, and manage plugins from the CLI
Free and open source