A QR code scanner component for Gimly ID

Usage no npm install needed!

<script type="module">
  import gimlyBlockchainRnGimlyidQrCodeScanner from 'https://cdn.skypack.dev/@gimly-blockchain/rn-gimlyid-qr-code-scanner';


A GimlyID QR code scanner component for React-Native

A GimlyID QR code scanner component for React-Native. This scanner can scan QR codes generated by the gimlyid-qr-code-generator component.


import GimlyIDQRCodeScanner from '@gimly-blockchain/rn-gimlyid-qr-code-scanner';

function App() {
 return (
     <GimlyIDQRCodeScanner style={{flex: 1, width: '100%'}} onRead={content => console.log(content)}/>

Note: Notice the style attribute added to the camera in order for it to take the full screen. Without these styles, you may not be able to see the camera render on your screen, as it will not occupy any space.


prop type default value description
style React.CSSProperties Sets the styling of the qr code scanner.
onRead Function The onRead will be called when the QR code is read and will have access to the QR content.



You must add the following permissions to android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />

You’ll also need to set the dimension strategy in android/app/build.gradle. It has no default and you’ll get an error if you don’t define it:

defaultConfig {
 applicationId "com.cameraexample"
 minSdkVersion rootProject.ext.minSdkVersion
 missingDimensionStrategy 'react-native-camera', 'general'
 targetSdkVersion rootProject.ext.targetSdkVersion
 versionCode 1
 versionName "1.0"

Note: The dimension strategy should normally be set to general as above. However, you can set it to mlkit instead, if you’d like to use MLKit for QR recognition.


You must update Info.plist with a usage description for camera

<string>Your own description of the purpose</string>


yarn add @gimly-blockchain/rn-gimlyid-qr-code-scanner


yarn build

Utility scripts

There are other utility scripts that help with development.

  • yarn fix - runs eslint --fix as well as prettier to fix code style.