Install the SDK on Capacitor

In this guide, you will learn how to get started with the Genius Scan SDK for Capacitor.

Package information

• npm package: @thegrizzlylabs/capacitor-plugin-genius-scan
• Supported platforms: iOS 15.0+, Android 24+
• Capacitor: 8+

Setup

Installation

Install the plugin from your Capacitor application:

npm install @thegrizzlylabs/capacitor-plugin-genius-scan@6.6.0
npx cap sync

Android configuration

Android builds require Java 21. Use Android Gradle Plugin 9.4.1 with a compatible Gradle wrapper; the SDK demo uses Gradle 9.7.1. Set compileSdkVersion to 37 or later and minSdkVersion to 24 or later in android/variables.gradle. The plugin adds the Genius Scan Maven repository to its Android library.

iOS configuration

Add the required camera permission to your app’s Info.plist:

<key>NSCameraUsageDescription</key>
<string>We use the camera to scan documents</string>

TypeScript projects

The Capacitor package declares structuredData as unknown, so TypeScript apps should narrow it to the expected receipt, barcode, or custom shape before reading extracted fields.

What’s Next?

Next, configure a license key. To compare with a working integration, see the sample apps.