https://github.com/getsettalk/react-native-qr-kit
Decode QR codes from images, decode multiple QR codes, decode from base64, and generate QR codes — all locally, with no network required.
https://github.com/getsettalk/react-native-qr-kit
react-native react-native-app react-native-qr-kit
Last synced: 9 months ago
JSON representation
Decode QR codes from images, decode multiple QR codes, decode from base64, and generate QR codes — all locally, with no network required.
- Host: GitHub
- URL: https://github.com/getsettalk/react-native-qr-kit
- Owner: getsettalk
- Created: 2025-08-24T09:00:23.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-23T11:58:00.000Z (10 months ago)
- Last Synced: 2025-09-23T13:34:01.245Z (10 months ago)
- Topics: react-native, react-native-app, react-native-qr-kit
- Language: Swift
- Homepage: https://www.npmjs.com/package/react-native-qr-kit
- Size: 506 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# react-native-qr-kit
[](https://www.npmjs.com/package/react-native-qr-kit)
[](https://www.npmjs.com/package/react-native-qr-kit)
[](LICENSE)
> **A fast, offline, and fully native QR code toolkit for React Native (Android and iOS).**
> Decode QR codes from images, decode multiple QR codes, decode from base64, and generate QR codes — all locally, with no network required.
---
## ✨ Features
- **Offline**: All QR code operations are performed locally on the device.
- **Decode from Image**: Extract QR code data from any image file.
- **Decode from Base64**: Decode QR code from a base64-encoded image string.
- **Decode Multiple**: Detect and decode multiple QR codes in a single image.
- **Generate QR Code**: Create QR codes as base64 PNG images.
- **Native Performance**: Built with native Android and iOS code for speed and reliability.
- **Easy Integration**: Simple API for React Native apps.
> **Note:**
> While the library is fully focused on QR codes, decoding other barcode formats may not work reliably on iOS. See [#screenshot](#Screenshots) below for an example.
---
## 📦 Installation
```sh
npm install react-native-qr-kit
```
or
```sh
yarn add react-native-qr-kit
```
### iOS Setup
Run the following commands to install iOS dependencies:
```sh
cd ios
pod install
```
### Android Manual Linking (if needed)
If autolinking does not work, add the package manually in your `MainApplication.java`/`kt`:
```java
import com.qrkit.QRKitPackage; // <-- add this import
@Override
protected List getPackages() {
return Arrays.asList(
// ...other packages
new QRKitPackage() // <-- add this line
);
}
```
---
## 📋 Usage
### `decodeBase64`
Decodes a QR code from a base64-encoded image string.(e.g., "iVBORw0KGgo...")
#### Example:
```js
import QRKit from 'react-native-qr-kit';
const decodeBase64 = async (base64String) => {
try {
const result = await QRKit.decodeBase64(base64String);
if (result.success) {
console.log('QR Code Data:', result.data);
} else {
console.error('Error:', result.message);
}
} catch (error) {
console.error('Unexpected Error:', error);
}
};
```
#### Expected Response:
```js
{
success: true,
data: string
}
// or on failure
{
success: false,
message: string
}
```
---
### `decodeQR`
Decodes a QR code from a local file path.
#### Example:
```js
import QRKit from 'react-native-qr-kit';
const decodeQR = async (ImagePath) => {
try {
const result = await QRKit.decodeQR(ImagePath);
if (result.success) {
console.log('QR Code Data:', result.data);
} else {
console.error('Error:', result.message);
}
} catch (error) {
console.error('Unexpected Error:', error);
}
};
```
#### For image choose:
- you can use any library for select image, but i suggest `react-native-image-picker`
#### Expected Response:
```js
{
success: true,
data: string, // QR code content
error: null,
format: string, // QR code format (e.g. 'QR_CODE')
points: string[] // Array of detected points (e.g. ["120.0,45.0", ...])
}
// or on failure
{
success: false,
errorType: string,
message: string,
details?: string,
stack?: string
}
```
---
### `decodeMultiple`
Decodes multiple QR codes from a local file path.
#### Example:
```js
import QRKit from 'react-native-qr-kit';
const decodeMultiple = async (ImagePath) => {
try {
const result = await QRKit.decodeMultiple(ImagePath);
if (result.success) {
console.log('QR Codes:', result.results);
} else {
console.error('Error:', result.message);
}
} catch (error) {
console.error('Unexpected Error:', error);
}
};
```
#### For image choose:
- you can use any library for select image, but i suggest `react-native-image-picker`
#### Expected Response:
```js
{
success: true,
results: [
{ data: string, format: string },
...
]
}
// or on failure
{
success: false,
message: string
}
```
---
### `generateQRCode`
Generates a QR code as a base64 PNG image.
#### Example:
```js
import QRKit from 'react-native-qr-kit';
const generateQRCode = async (data, size) => {
try {
const result = await QRKit.generateQRCode(data, size);
if (result.success) {
console.log('Generated QR Code (Base64):', result.base64);
} else {
console.error('Error:', result.message);
}
} catch (error) {
console.error('Unexpected Error:', error);
}
};
```
#### Expected Response:
```js
{
success: true,
base64: string // PNG image as base64
}
// or on failure
{
success: false,
message: string
}
```
---
## 📋 API Reference
### `decodeQR(path: string): Promise`
Decode a QR code from a local image file path.
**Returns:**
```js
{
success: true,
data: string, // QR code content
error: null,
format: string, // QR code format (e.g. 'QR_CODE')
points: string[] // Array of detected points (e.g. ["120.0,45.0", ...])
}
// or on failure
{
success: false,
errorType: string,
message: string,
details?: string,
stack?: string
}
```
### `decodeBase64(base64Str: string): Promise`
Decode a QR code from a base64-encoded image string.
**Returns:**
```js
{
success: true,
data: string
}
// or on failure
{
success: false,
message: string
}
```
### `decodeMultiple(path: string): Promise`
Decode multiple QR codes from a local image file path.
**Returns:**
```js
{
success: true,
results: [
{ data: string, format: string },
...
]
}
// or on failure
{
success: false,
message: string
}
```
### `generateQRCode(data: string, size: number): Promise`
Generate a QR code as a base64 PNG image.
**Returns:**
```js
{
success: true,
base64: string // PNG image as base64
}
// or on failure
{
success: false,
message: string
}
```
---
## Screenshots
---
## ℹ️ Notes
- All QR code decoding and generation is performed **offline** and locally on the device.
- The library is fully focused on QR codes. Decoding other barcode formats may not work reliably on iOS.
- Works with any local image file path accessible to your app.
---
## 📄 License
MIT © [getsettalk](https://github.com/getsettalk)