July 30, 2026 — The unofficial Laracon US Day 3. Get your ticket to The Vibes
Plugin Marketplace
srwiez/nativephp-mobile-screen logo

srwiez/nativephp-mobile-screen

Screen wake lock and brightness control for NativePHP Mobile apps

Screen for NativePHP Mobile#

Keep screens awake. Control brightness. Built for apps users stare at.#

Screen plugin on iOS Screen plugin on Android

A tiny, focused NativePHP plugin for two things mobile devs constantly need: keeping the screen on and controlling brightness. One facade, six methods, zero setup.

Why this plugin?#

  • ☀️ Keep the screen awake — perfect for barcode tickets, live dashboards, kiosks and scoring apps.
  • 🔆 Control brightness — crank to 100% to scan barcodes in sunlight, dim down for dark reading rooms.
  • 🪶 Dependency-free — a single wake-lock + brightness wrapper. No bloat, no configuration.
  • 📱 Works everywhere — iOS 13+ and Android 5+ (API 21).

Features at a glance#

Feature Android iOS
Keep screen awake
Set brightness (0.0–1.0)
Reset to system default

Perfect for#

Ticket & boarding-pass apps · Barcode / QR scanners · Kiosk & POS apps · Sports scoreboards · Live dashboards & monitoring · E-readers


Installation#

Copied!
# Install the package
composer require srwiez/nativephp-mobile-screen
 
# Publish the plugins provider (first time only)
php artisan vendor:publish --tag=nativephp-plugins-provider
 
# Register the plugin
php artisan native:plugin:register srwiez/nativephp-mobile-screen
 
# Verify registration
php artisan native:plugin:list

This adds \SRWieZ\NativePHP\Mobile\Screen\MobileScreenServiceProvider::class to your plugins() array.

Usage#

PHP (Livewire/Blade)#

Copied!
use SRWieZ\NativePHP\Mobile\Screen\Facades\MobileScreen;
 
// Keep screen awake
MobileScreen::keepAwake(); // true if wake lock enabled
 
// Allow screen to sleep
MobileScreen::allowSleep(); // true if wake lock disabled
 
// Check wake lock status
$isAwake = MobileScreen::isAwake(); // bool
 
// Set brightness (0.0 to 1.0)
$level = MobileScreen::setBrightness(1.0); // returns actual level, or false on failure
 
// Get current brightness
$level = MobileScreen::getBrightness(); // float or null
 
// Reset to system default
MobileScreen::resetBrightness(); // returns level or false on failure

JavaScript (Vue/React/Inertia)#

Copied!
import { mobileScreen } from '@srwiez/nativephp-mobile-screen';
 
// Keep screen awake
await mobileScreen.keepAwake();
 
// Set maximum brightness
await mobileScreen.setBrightness(1.0);
 
// Reset when done
await mobileScreen.resetBrightness();
await mobileScreen.allowSleep();

API Reference#

Method Returns Description
keepAwake(bool $enabled = true) bool Enable/disable screen wake lock
allowSleep() bool Alias for keepAwake(false)
isAwake() bool Check if wake lock is active
setBrightness(float $level) bool|float Set brightness (0.0-1.0). Returns actual level or false on failure
getBrightness() ?float Get current brightness level
resetBrightness() bool|float Reset to system default. Returns level or false on failure

Version Support#

Platform Minimum Version
Android 5.0 (API 21)
iOS 13.0

More NativePHP Mobile plugins#

Building a mobile app with NativePHP? Check out the rest of the suite:

  • Calendar — Native calendars & events from PHP, on both platforms.
  • Contacts — Read, create & sync the device address book straight from Laravel.
  • Screenshots — Lock down sensitive screens, catch capture attempts, respond instantly.

Support#

Bugs, questions, and feature requests should be reported at github.com/SRWieZ/nativephp-mobile-screen/issues.