# react-qr-code

> A QR code generator for React and React Native.

Latest version **2.2.0** (published 2026-06-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-qr-code
pnpm add react-qr-code
yarn add react-qr-code
bun add react-qr-code
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.2.0 |
| Published | 2026-06-09 |
| First published | 2016-07-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 19.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 892 |
| Author | Ross Khanas |
| Maintainers | rtkhanas |
| Keywords | code, generator, qr, react, react-native |

## Links

- npm: https://www.npmjs.com/package/react-qr-code
- Repository: https://github.com/rosskhanas/react-qr-code
- Homepage: https://github.com/rosskhanas/react-qr-code#readme
- Issues: https://github.com/rosskhanas/react-qr-code/issues
- npm.io page: https://npm.io/package/react-qr-code

## Dependencies (2)

- [prop-types](https://npm.io/package/prop-types.md) ^15.8.1
- [qrcode-generator](https://npm.io/package/qrcode-generator.md) ^2.0.4

## Alternatives

- [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads
- [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads
- [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads
- [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads
- [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads

## Recent versions

- 2.2.0 (latest) — 2026-06-09
- 2.1.1 — 2026-06-08
- 2.1.0 — 2026-06-08
- 2.0.21 — 2026-04-29
- 2.0.20 — 2026-04-29
- 2.0.19 — 2026-04-29
- 2.0.18 — 2025-07-06
- 2.0.17 — 2025-07-04
- 2.0.16 — 2025-06-16
- 2.0.15 — 2024-06-20
- 2.0.14 — 2024-06-02
- 2.0.13 — 2024-05-13
- 2.0.12 — 2023-08-13
- 2.0.11 — 2022-12-13
- 2.0.10 — 2022-12-13
- … 29 more at https://npm.io/package/react-qr-code/versions

## README

# react-qr-code

[![npm package](https://badge.fury.io/js/react-qr-code.svg)](https://www.npmjs.org/package/react-qr-code)

A <QRCode /> component for React. This library works with React and React Native (using [React Native SVG](https://github.com/react-native-svg/react-native-svg)).

### Screenshots

#### [Web](https://rosskhanas.github.io/react-qr-code/)

<img src="https://github.com/rosskhanas/react-qr-code/blob/master/demo-web.png" width="640" />

#### Android & iOS

<div float="left">
    <img src="https://github.com/rosskhanas/react-qr-code/blob/master/demo-android.png" width="320" />
    <img src="https://github.com/rosskhanas/react-qr-code/blob/master/demo-ios.png" width="265" />
</div>

### Installation

```
npm i react-qr-code
```

When using this library with React Native, you will also need to [have `react-native-svg` installed](https://github.com/react-native-svg/react-native-svg#installation).

```
npm i react-native-svg
cd ios && pod install
```

### The Gist

```javascript
import React from "react";
import ReactDOM from "react-dom";
import QRCode from "react-qr-code";

ReactDOM.render(<QRCode value="hey" />, document.getElementById("Container"));
```

Note: If the QR code is likely to appear next to dark objects, you will need to wrap it in a light-colored container to preserve the '[quiet zone](https://qrworld.wordpress.com/2011/08/09/the-quiet-zone/)', e.g.

```javascript
<div style={{ background: 'white', padding: '16px' }}>
  <QRCode ... />
</div>
```

Responsive QR code example:

```javascript
// Can be anything instead of `maxWidth` that limits the width.
<div style={{ height: "auto", margin: "0 auto", maxWidth: 64, width: "100%" }}>
  <QRCode
    size={256}
    style={{ height: "auto", maxWidth: "100%", width: "100%" }}
    value={value}
    viewBox={`0 0 256 256`}
  />
</div>
```

### API

| prop      | type                         | default value | platform          |
| --------- | ---------------------------- | ------------- | ----------------- |
| `bgColor` | `string`                     | '#FFFFFF'     | web, ios, android |
| `fgColor` | `string`                     | '#000000'     | web, ios, android |
| `level`   | `string` (`'L' 'M' 'Q' 'H'`) | 'L'           | web, ios, android |
| `size`    | `number`                     | 256           | web, ios, android |
| `title`   | `string`                     |               | web               |
| `value`   | `string`                     |               | web, ios, android |

Adheres to the [official QR spec](https://www.qrcode.com/en/about/version.html) and can store up to 2953 characters in `value`.

### Non-ASCII / UTF-8 text

`react-qr-code` encodes data in UTF-8 byte mode to ensure non-ASCII text (e.g., Korean, Japanese, emoji) renders and scans correctly. Just pass a normal JavaScript string:

```javascript
<QRCode value="한글 테스트 😊" />
```

No additional encoding is required on your side.

### Testing UTF-8 locally

1. Build the demo library bundle in watch mode:
   - In one terminal: `npm run demo-web-watch`
2. Run the demo app:
   - In another terminal: `npm run demo`
3. Open the demo in your browser (Expo starts it automatically) and type a non-ASCII value (e.g., `안녕하세요`,
   `こんにちは`, or an emoji) into the input.
4. Scan the QR code with a phone camera app. The decoded text should match exactly.

### License

MIT

---
_Source: https://npm.io/package/react-qr-code · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._