![\"Oppenheimer](\"https://media1.tenor.com/m/ULb88LZ1oM0AAAAd/oppenheimer-paradoxical.gif\")
\n\n \n
\"It is paradoxical, yet it works.\"
\n\nApproaching 100,000 npm downloads š
\n\nHigh-performance React Native PDF viewer with JSI (JavaScript Interface) acceleration. A drop-in replacement for `react-native-pdf` with enhanced performance, Google Play compliance, and advanced features.\n\n**Latest (`4.5.0`):** native PDF text extraction plus optional on-device OCR (iOS Vision / Android ML Kit), searchable PDF export, and OCR highlight helpers. See [README_OCR.md](README_OCR.md) and [CHANGELOG.md](CHANGELOG.md).\n\n## Features\n\n### Core Functionality\n- Read PDFs from URL, blob, local file, or asset with caching support\n- Horizontal and vertical display modes\n- **Pinch-to-zoom** and drag with double-tap support (iOS & Android)\n- Password-protected PDF support\n- Programmatic page navigation\n- Cross-platform support (iOS, Android, Windows)\n\n### Performance Optimizations\n- **JSI Integration**: Direct JavaScript-to-Native communication (up to 80x faster than bridge)\n- **Lazy Loading**: Optimized loading for large PDF files with configurable preload radius\n- **Smart Caching**: 30-day persistent cache with intelligent memory management\n- **Progressive Loading**: Batch-based loading for optimal user experience\n- **Memory Optimization**: Automatic memory management and cleanup for large documents\n\n### Advanced Features (All Free)\n- **Bookmarks**: Create, edit, delete bookmarks with 10 custom colors and notes\n- **Reading Analytics**: Track reading sessions, progress, speed, and engagement metrics\n- **Export Operations**: Export pages to PNG/JPEG with quality control\n- **PDF Operations**: Split, merge, extract, rotate, and delete pages\n- **PDF Compression**: Reduce file sizes with 5 smart presets (EMAIL, WEB, MOBILE, PRINT, ARCHIVE)\n- **Text Extraction & Search**: Extract and search text with statistics and context; **programmatic search** via `searchTextDirect(pdfId, term, startPage, endPage)` with bounding rects, and **highlight rendering** via `pdfId` + `highlightRects` props (Android & iOS)\n- **PDF Text & OCR**: Native extraction + optional on-device OCR (`PDFText`); searchable PDF (`makeSearchablePDF`); OCR highlight mapping. See [README_OCR.md](README_OCR.md).\n- **File Management** (Android): Download to public storage, open folders with MediaStore API\n\n### Compliance & Compatibility\n- **Google Play 16KB Compliant**: Built with NDK r28.2+ for Android 15+ requirements\n- **Future-Proof**: Latest Android development toolchain and modern architecture\n- **Drop-in Replacement**: Easy migration from existing PDF libraries\n- **Production Ready**: Stable and tested in production environments\n\n## Performance Benchmarks\n\n| Operation | Time | Throughput | Memory | vs Competition |\n|-----------|------|------------|--------|----------------|\n| 88MB PDF Compression | 13-16ms | 6,382 MB/s | 2 MB | 20-380x faster |\n| Image Export (JPEG) | 37ms | N/A | 2 MB | 5.2x faster than PNG |\n| Image Export (PNG) | 194ms | N/A | 2 MB | Baseline |\n| File I/O Operations | <2ms | N/A | Minimal | Instant |\n| Page Navigation | 0-3ms | N/A | Constant | Instant |\n\n**Key Achievements:**\n- O(1) Memory Complexity - Constant 2MB usage for files from 10MB to 10GB+\n- 5.2x Faster Image Export - JPEG format with 90% quality (visually identical)\n- 6+ GB/s Throughput - Industry-leading PDF compression speed\n- Zero Crashes - Handles files other libraries can't (tested up to 10GB)\n\n## Installation\n\n```bash\n# Using npm\nnpm install react-native-pdf-jsi react-native-blob-util --save\n\n# or using yarn\nyarn add react-native-pdf-jsi react-native-blob-util\n```\n\n### iOS Installation\n\n**React Native 0.60 and above:**\n```bash\ncd ios && pod install\n```\n\n**React Native 0.59 and below:**\n```bash\nreact-native link react-native-blob-util\nreact-native link react-native-pdf-jsi\n```\n\n### Android Installation\n\n**React Native 0.59.0 and above:**\nAdd the following to your `android/app/build.gradle`:\n\n```gradle\nandroid {\n packagingOptions {\n pickFirst 'lib/x86/libc++_shared.so'\n pickFirst 'lib/x86_64/libjsc.so'\n pickFirst 'lib/arm64-v8a/libjsc.so'\n pickFirst 'lib/arm64-v8a/libc++_shared.so'\n pickFirst 'lib/x86_64/libc++_shared.so'\n pickFirst 'lib/armeabi-v7a/libc++_shared.so'\n }\n}\n```\n\n**React Native 0.59.0 and below:**\n```bash\nreact-native link react-native-blob-util\nreact-native link react-native-pdf-jsi\n```\n\n### Expo Installation\n\nThis package works with **Expo development builds** (not Expo Go, as it requires native code).\n\n**1. Install the package and peer dependencies:**\n\n```bash\nnpx expo install react-native-pdf-jsi react-native-blob-util @react-native-async-storage/async-storage\n```\n\n**2. Add the config plugin to your `app.json` or `app.config.js`:**\n\n```json\n{\n \"expo\": {\n \"plugins\": [\"react-native-pdf-jsi\"]\n }\n}\n```\n\nOptional OCR (Android ML Kit):\n\n```json\n{\n \"expo\": {\n \"plugins\": [[\"react-native-pdf-jsi\", { \"ocr\": true }]]\n }\n}\n```\n\n**3. Rebuild your development build:**\n\n```bash\n# Generate native projects\nnpx expo prebuild\n\n# Run on iOS\nnpx expo run:ios\n\n# Run on Android\nnpx expo run:android\n```\n\n> **Note:** The config plugin automatically configures:\n> - Android: Adds Jitpack repository for PDF rendering dependencies\n> - iOS: Ensures PDFKit framework is properly linked\n\n**For EAS Build users:**\n\n```bash\n# Build development client\neas build --profile development --platform ios\neas build --profile development --platform android\n```\n\n### Windows Installation\n\n1. Open your solution in Visual Studio 2019 (e.g., `windows\\yourapp.sln`)\n2. Right-click Solution icon in Solution Explorer > Add > Existing Project...\n3. Add `node_modules\\react-native-pdf-jsi\\windows\\RCTPdf\\RCTPdf.vcxproj`\n4. Add `node_modules\\react-native-blob-util\\windows\\ReactNativeBlobUtil\\ReactNativeBlobUtil.vcxproj`\n5. Right-click main application project > Add > Reference...\n6. Select `RCTPdf` and `ReactNativeBlobUtil` in Solution Projects\n7. In app `pch.h` add:\n ```cpp\n #include \"winrt/RCTPdf.h\"\n #include \"winrt/ReactNativeBlobUtil.h\"\n ```\n8. In `App.cpp` add before `InitializeComponent();`:\n ```cpp\n PackageProviders().Append(winrt::RCTPdf::ReactPackageProvider());\n PackageProviders().Append(winrt::ReactNativeBlobUtil::ReactPackageProvider());\n ```\n\n## Quick Start\n\n```jsx\nimport React, { useState } from 'react';\nimport { View, StyleSheet } from 'react-native';\n\nconst PdfModule = require('react-native-pdf-jsi');\nconst Pdf = PdfModule.default;\n\nexport default function PDFExample() {\n const [totalPages, setTotalPages] = useState(0);\n const [currentPage, setCurrentPage] = useState(1);\n\n const source = { \n uri: 'https://example.com/document.pdf', \n cache: true \n };\n\n return (\n