Skip to main content
Firstlight / NativePHP

Firstlight / Docs

Native controls, familiar Blade, and the implementation details in between.

View source
Install Firstlight UI

Install Firstlight UI

Requirements

Start with a NativePHP Mobile 4 application that meets the current compatibility requirements.

Install and register the plugin

Install Firstlight as a normal Composer dependency:

composer require firstlightui/nativephp

Laravel discovers FirstlightUI\FirstlightServiceProvider from the package metadata. Register the native plugin explicitly so NativePHP adds the renderers declared in nativephp.json to the application:

php artisan native:plugin:register

The command discovers unregistered plugins. If your application disables Laravel package discovery, register FirstlightUI\FirstlightServiceProvider through the application's normal provider configuration as well.

Rebuild the native projects

Native renderer source is compiled into the host application. Regenerate the native projects after installing or updating Firstlight:

php artisan native:install --force

Build and run the application through your normal NativePHP workflow. Firstlight's <firstlight:...> tags are collected as native elements only in a native render; an ordinary web render leaves them unchanged.

Next step

Add your first Firstlight component to your application.

Served from firstlightui/nativephp and cached for a fast first read.