PHPackages                             projectmata/mobile-biometrics - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. projectmata/mobile-biometrics

ActiveNativephp-plugin[Authentication & Authorization](/categories/authentication)

projectmata/mobile-biometrics
=============================

Biometric authentication plugin for NativePHP Mobile

v1.0.0(3mo ago)09↓50%MITKotlinPHP ^8.1

Since Apr 25Pushed 3mo agoCompare

[ Source](https://github.com/jomarmata24/mobile-biometrics)[ Packagist](https://packagist.org/packages/projectmata/mobile-biometrics)[ RSS](/packages/projectmata-mobile-biometrics/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Projectmata Mobile Biometrics
=============================

[](#projectmata-mobile-biometrics)

Biometric authentication plugin for [NativePHP Mobile](https://nativephp.com). Exposes fingerprint / Face ID / device-credential authentication to your Laravel + NativePHP app on Android and iOS.

Requirements
------------

[](#requirements)

- PHP `^8.1`
- Laravel `^11.0` or `^12.0` / `^13.0`
- `nativephp/mobile`
- Android: `min_version 33` (depends on `androidx.biometric:biometric:1.2.0-alpha05`)
- iOS: `min_version 18.2`

Installation
------------

[](#installation)

```
composer require projectmata/mobile-biometrics
```

Laravel auto-discovery registers the service provider and facade automatically — no edits to `config/app.php` or `bootstrap/providers.php` needed.

After installing, rebuild the mobile app so NativePHP picks up the new plugin manifest:

```
php artisan native:run android
# or
php artisan native:run ios
```

Usage
-----

[](#usage)

### PHP (Laravel)

[](#php-laravel)

```
use Projectmata\MobileBiometrics\Facades\Biometrics;

// Is biometric hardware available & enrolled?
$status = Biometrics::isAvailable();

// What authenticators does the device expose?
$types = Biometrics::getTypes();

// Prompt the user to authenticate
$result = Biometrics::authenticate(
    reason: 'Confirm your identity to continue',
    title: 'Unlock',
    subtitle: 'Use your fingerprint or face',
    negativeButton: 'Cancel',
);

if ($result['success'] ?? false) {
    // authenticated
}
```

### JavaScript (in-app)

[](#javascript-in-app)

The plugin registers itself on `window.NativePHP.Biometrics`:

```
const available = await window.NativePHP.Biometrics.IsAvailable();
const types     = await window.NativePHP.Biometrics.GetTypes();

const result = await window.NativePHP.Biometrics.Authenticate({
    reason: 'Confirm your identity',
    title: 'Unlock',
    subtitle: '',
    negativeButton: 'Cancel',
});
```

You can also import the module directly if you bundle it:

```
import Biometrics, { authenticate } from 'projectmata-mobile-biometrics';
```

Bridge methods
--------------

[](#bridge-methods)

MethodParamsReturns`Biometrics.IsAvailable`—`{ success, available, reason }``Biometrics.GetTypes`—`{ success, types[] }``Biometrics.Authenticate``reason, title, subtitle, negativeButton``{ success, message }`Return payloads are whatever the native plugin resolves; at minimum each call returns a `success` boolean and a `message` on failure.

Platform notes
--------------

[](#platform-notes)

- **Android** — Uses AndroidX Biometric. Requires the device to have a biometric enrolled (or a device credential fallback, depending on config).
- **iOS** — Uses `LAContext` (Touch ID / Face ID). Face ID requires `NSFaceIDUsageDescription` in `Info.plist`; add it to your app's `info_plist` config if you target Face ID devices.

License
-------

[](#license)

MIT

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance82

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

91d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f5495492f5d4cf3c05ca542a5bbf714e889fdad7a60930fdde6eacf5dfe45151?d=identicon)[ramilojomar2001@gmail.com](/maintainers/ramilojomar2001@gmail.com)

---

Top Contributors

[![jomarmata24](https://avatars.githubusercontent.com/u/64277739?v=4)](https://github.com/jomarmata24 "jomarmata24 (1 commits)")

### Embed Badge

![Health badge](/badges/projectmata-mobile-biometrics/health.svg)

```
[![Health](https://phpackages.com/badges/projectmata-mobile-biometrics/health.svg)](https://phpackages.com/packages/projectmata-mobile-biometrics)
```

###  Alternatives

[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)[firemultimedia/mautic-multi-captcha-bundle

This plugin brings Google's reCAPTCHA, hCaptcha, and Cloudflare Turnstile integration to mautic.

141.3k](/packages/firemultimedia-mautic-multi-captcha-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)