NFC

Backed by tauri-plugin-nfc. Mobile only.

Blade:

<button wire:nb-bridge="nfc_read" wire:nb-payload='{"id":"identify_product"}'>
    Tap product tag
</button>

PHP:

use NativeBlade\Plugins\Nfc;

public function readProductTag()
{
    return NativeBlade::nfcRead(fn (Nfc $n) => $n->id('identify_product'))->toResponse();
}

public function readTicketTag()
{
    return NativeBlade::nfcRead(fn (Nfc $n) => $n->id('scan_ticket'))->toResponse();
}

#[On('nb:nfc')]
public function onNfcTag($tag, $id = null)
{
    match ($id) {
        'identify_product' => $this->loadProduct($tag['id']),
        'scan_ticket'      => $this->validateTicket($tag['id']),
        default            => null,
    };
}

Reading tags only while the app is open (default)

By default, NFC works through foreground dispatch: the plugin captures tags only while the user is inside the app and NativeBlade::nfcRead() was invoked. This is the behaviour 99% of apps want. No manifest filter is required, Plugin::NFC and the android.permission.NFC entry are enough.

Auto-launching the app from a tag (opt-in)

If your app is built around NFC (a transit reader, a payment terminal, an inventory scanner where the user taps the tag instead of opening the app first), you can declare an auto-launch filter via AndroidConfig::nfcAutoLaunch(). Android will then wake the device and bring your app to the front whenever a matching tag is presented.

use NativeBlade\Config\NfcTech;
use NativeBlade\Facades\NativeBladeConfig;

NativeBladeConfig::android(function ($c) {
    // (a) Any NFC tag wakes the app, broadest filter
    $c->nfcAutoLaunch(anyTag: true);

    // (b) Only tags exposing specific technologies wake the app
    $c->nfcAutoLaunch(techs: [NfcTech::ISO_DEP, NfcTech::MIFARE_CLASSIC]);

    // (c) Both
    $c->nfcAutoLaunch(anyTag: true, techs: [NfcTech::ISO_DEP]);
});

After declaring, run php artisan nativeblade:config to write the manifest filters and the res/xml/nfc_tech_filter.xml resource.

Warning: turning auto-launch on (especially anyTag: true or NfcTech::ISO_DEP) means contactless credit cards, transit cards, and corporate badges will wake the device and launch your app whenever they pass near the phone. That is the exact symptom users report when this is misconfigured. Only enable it if your app actually needs that behaviour.

Available NfcTech cases (mapping to android.nfc.tech.*):

The generator writes/removes the filters idempotently, drop the nfcAutoLaunch() call and rerun nativeblade:config to revert to the safe default.