Using Plugins

#Installing a Plugin

Plugins are standard Composer packages. Install them like any other Laravel package:

composer require vendor/nativephp-plugin-name

The plugin's PHP service provider will be auto-discovered by Laravel, but the native code won't be included in builds until you explicitly register it.

#Register the Plugin

For security, plugins must be explicitly registered before their native code is compiled into your app. This prevents transitive dependencies from automatically including native code without your consent.

First, ensure you've published the NativeServiceProvider:

php artisan vendor:publish --tag=nativephp-plugins-provider

Then register the plugin:

php artisan native:plugin:register vendor/nativephp-plugin-name

This adds the plugin to your app/Providers/NativeServiceProvider.php file.

#Verify Installation

Check that NativePHP sees your plugin:

php artisan native:plugin:list

You'll see the plugin name, version, and what it provides (bridge functions, events, hooks).

#Rebuild Your App

After installing a plugin, rebuild to compile its native code:

php artisan native:run

The plugin's Swift and Kotlin code gets compiled into your app automatically.

#Using Plugin Features

Each plugin provides its own facade for interacting with native functionality.

use Vendor\PluginName\Facades\PluginName;
 
// Call a native function
$result = PluginName::doSomething(['option' => 'value']);

#Listening to Plugin Events

Plugins dispatch events to your Livewire components. Use the #[OnNative] attribute to listen for them:

use Native\Mobile\Attributes\OnNative;
use Vendor\PluginName\Events\SomethingCompleted;
 
#[OnNative(SomethingCompleted::class)]
public function handleCompletion($result)
{
    // React to the event
}

#Permissions

Some plugins require additional permissions. These are declared in the plugin's manifest and automatically merged into your app's configuration during build.

If a plugin needs camera access, microphone, or other sensitive permissions, you'll see them listed when you run native:plugin:list.

#Removing a Plugin

To completely uninstall a plugin:

php artisan native:plugin:uninstall vendor/nativephp-plugin-name

This command:

• Unregisters the plugin from your NativeServiceProvider
• Removes the package via Composer
• Removes the path repository from composer.json (if applicable)
• Optionally deletes the plugin source directory (for local path repositories)

Use --force to skip confirmation prompts, or --keep-files to preserve the source directory when uninstalling a local plugin.

#Official Plugins & Dev Kit

Find ready-made plugins for common use cases, or get the Dev Kit to build your own. Visit the NativePHP Plugin Marketplace →