Native features for NativePHP apps.

Privacy cover

Blurs the app in the iOS app switcher. On Android it sets FLAG_SECURE, which also blocks screenshots and screen recording.

Return shield

After a timeout you choose, an opaque view covers the app before its first frame on return, so nothing shows until your lock screen is ready. It shows your own image, your splash screen or your app icon.

App lock

An app-lock route middleware and a RequiresUnlock trait keep protected screens closed while the app is locked, including deep links. The unlocked state lives in memory, so every cold start begins locked.

Optional PIN

Stores only a password hash in secure storage, with a wrong-attempt budget that survives restarts.

Sensitive copy

Puts text on the clipboard for this device only and removes it after up to an hour.

Lifecycle events

Backgrounded and Foregrounded, with time away measured natively on a clock that keeps running while the device sleeps.

App switcher

iOS: A blur over the app while it is inactive

Android: FLAG_SECURE: the app shows blank and can’t be captured

Return after the timeout

iOS: The shield over every window before the first frame

Android: The shield over the window before the first frame

Unlock prompt, with nativephp/mobile-biometrics

iOS: Face ID or Touch ID, falling back to the device passcode

Android: Fingerprint or face unlock, with no passcode fallback

$ composer require firstlightui/app-guard
$ php artisan native:plugin:register firstlightui/app-guard

Route::middleware('app-lock')->group(function () {
    Route::native('/vault', VaultScreen::class)->name('vault');
    Route::native('/lock', LockScreen::class)->name('lock');
});

// A screen with protected content
class VaultScreen extends NativeComponent
{
    use RequiresUnlock;
}

Requires PHP 8.4 or later, NativePHP Mobile ^4.7, iOS 18 or later, Android 10 (API 29) or later. The PIN needs nativephp/mobile-secure-storage at runtime.

The model the phone already has

Apple Foundation Models on iOS, Gemini Nano through ML Kit GenAI on Android.

Prompts and chats

Generate from one prompt with optional instructions, or continue a conversation, with temperature and a token limit.

Streamed output

Each chunk of text arrives as an event, then a completed, failed or cancelled event. Cancel a generation at any time.

Availability with a reason

Tells you whether the model is available, downloadable, downloading or unavailable, and why, such as Apple Intelligence being turned off.

Survives navigation

Each generation has an ID, so a screen can pick up its text again after the user navigates away and back.

Model

iOS: Apple Foundation Models

Android: Gemini Nano, through the ML Kit GenAI Prompt API

Generates on

iOS: iOS 26 or later on a device with Apple Intelligence turned on

Android: Devices that support AICore, with a locked bootloader

Installs on

iOS: iOS 18 or later

Android: Android 10 (API 29) or later