# react-native-nfc-manager
> A NFC module for react native.
Latest version **4.0.0** (published 2026-10-09) · MIT license · 0 weekly downloads
## Install
```sh
npm install react-native-nfc-manager
pnpm add react-native-nfc-manager
yarn add react-native-nfc-manager
bun add react-native-nfc-manager
```
## Health
**Score 70/100 (B)** — status: active.
Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.
Warnings: low downloads; no esm support.
## Facts
| | |
|---|---|
| Version | 4.0.0 |
| Published | 2026-10-09 |
| First published | 2017-07-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 433.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1638 |
| Author | Richie |
| Maintainers | whitedogg13 |
| Keywords | react-native, android, ios, nfc |
## Links
- npm: https://www.npmjs.com/package/react-native-nfc-manager
- Repository: https://github.com/revtel/react-native-nfc-manager
- Homepage: https://github.com/revtel/react-native-nfc-manager#readme
- Issues: https://github.com/revtel/react-native-nfc-manager/issues
- npm.io page: https://npm.io/package/react-native-nfc-manager
## Alternatives
- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads
## Recent versions
- 4.0.0 (latest) — 2026-10-09
- 4.0.0-beta.11 (beta) — 2026-10-09
- 3.17.5 — 2026-10-03
- 3.17.4 — 2026-10-03
- 4.0.0-beta.10 — 2026-10-03
- 3.17.3 — 2026-10-03
- 4.0.0-beta.9 — 2026-09-08
- 4.0.0-beta.8 — 2026-09-08
- 3.17.2 — 2025-11-28
- 4.0.0-beta.7 — 2025-11-28
- 4.0.0-beta.6 — 2025-09-27
- 3.17.1 — 2025-09-27
- 4.0.0-beta.5 — 2025-09-21
- 3.17.0 — 2025-09-21
- 3.16.3 — 2025-08-19
- … 123 more at https://npm.io/package/react-native-nfc-manager/versions
## README
# react-native-nfc-manager
[](https://www.npmjs.com/package/react-native-nfc-manager)
[](https://github.com/revtel/react-native-nfc-manager/actions/workflows/ci.yml)
NFC for React Native, built for the **New Architecture** and **Expo Development Builds**.
Requires **React Native 0.76+ with the New Architecture**. Use an NFC-capable physical device to test scans.
## Installation
```sh
npm install react-native-nfc-manager@beta
```
v4 is currently beta. Pin the resolved version for reproducible installs. See [migration](docs/MIGRATING_V3_TO_V4.md) when upgrading an existing app.
### Expo Development Builds
Expo Go cannot load this native module. Add the config plugin to `app.json`:
```json
{
"expo": {
"plugins": ["react-native-nfc-manager"]
}
}
```
Install the development client and build the native app:
```sh
npx expo install expo-dev-client
npx expo prebuild
npx expo run:ios --device
# Or: npx expo run:android --device
npx expo start --dev-client
```
Rebuild after changing native dependencies or plugin options. For iOS capabilities and plugin options, see [Expo setup](docs/guide/expo.md).
### React Native CLI
- **iOS:** run `pod install`, then configure [NFC capabilities and usage description](docs/guide/ios.md).
- **Android:** the module is autolinked; check [NFC permissions and device support](docs/guide/android.md), then rebuild the app.
## Read an NDEF tag
Call this function from a user action. It prevents overlapping scans and awaits cleanup before allowing another request.
```javascript
import NfcManager, {NfcTech} from 'react-native-nfc-manager';
let scanning = false;
async function readNdef() {
if (scanning) return;
scanning = true;
let requestAttempted = false;
try {
await NfcManager.start();
requestAttempted = true;
await NfcManager.requestTechnology(NfcTech.Ndef);
const tag = await NfcManager.getTag();
console.log('NDEF records', tag?.ndefMessage ?? []);
} catch (error) {
console.warn('NFC scan ended', error);
} finally {
try {
if (requestAttempted) {
await NfcManager.cancelTechnologyRequest();
}
} catch (cleanupError) {
console.warn('NFC cleanup failed', cleanupError);
} finally {
scanning = false;
}
}
}
```
For a complete React screen and session lifecycle, see [reading NDEF tags](docs/guide/reading-ndef.md).
## Technology support
| Technology | Android | iOS |
| --- | --- | --- |
| NDEF, NFC-A, ISO-DEP | ✅ | ✅ |
| NFC-V / ISO 15693 | `NfcV` | `Iso15693IOS` |
| MIFARE | `MifareClassic`, `MifareUltralight` | `MifareIOS` |
| FeliCa | `NfcF` | `FelicaIOS` |
See the [full technology and handler table](docs/reference/compatibility.md). Actual tag support depends on the device and OS.
## Documentation
Start with the [v4 documentation index](docs/index.md).
- [Installation and runtime requirements](docs/guide/installation.md)
- [Expo setup](docs/guide/expo.md) · [iOS setup](docs/guide/ios.md) · [Android setup](docs/guide/android.md)
- [API and handlers](docs/reference/api.md)
- [Expo troubleshooting](docs/EXPO_TROUBLESHOOTING.md)
- [Support policy](docs/SUPPORT_POLICY.md) · [Changelog](CHANGELOG.md)
## Examples and contributing
The [development example](example/README.md) exercises the New Architecture API. [Contributing](docs/CONTRIBUTING.md) includes build instructions and the NFC ReWriter app.
Created by [whitedogg13](https://github.com/whitedogg13).
---
_Source: https://npm.io/package/react-native-nfc-manager · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._