System Plugin for NativePHP Mobile#

System-level operations for NativePHP Mobile apps.

Overview#

The System API provides access to system-level functionality like platform detection and opening the app's settings page.

Installation#

composer require nativephp/mobile-system

Usage#

PHP (Livewire/Blade)#

use Native\Mobile\Facades\System;
 
// Platform detection
System::isIos();       // true on iOS
System::isAndroid();   // true on Android
System::isMobile();    // true on either platform
 
// Open app settings (useful when user denied permissions)
System::appSettings();
 
// Toggle the flashlight
System::flashlight();

JavaScript (Vue/React/Inertia)#

import { System } from '#nativephp';
 
// Open app settings
await System.openAppSettings();

Methods#

isIos(): bool#

Returns true if the app is running on iOS.

isAndroid(): bool#

Returns true if the app is running on Android.

isMobile(): bool#

Returns true if the app is running on iOS or Android.

appSettings(): void#

Opens the app's settings screen in the device settings. This is useful when a user has denied a permission and you want to direct them to the settings to grant it.

flashlight(): void#

Toggles the device flashlight on/off.

Use Cases#

• Detect the current platform to conditionally render UI
• Direct users to grant permissions after initial denial
• Allow users to change notification preferences

License#

MIT