@kishannareshpal/expo-pdf 0.1.0

package/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

package/.eslintrc.js

@@ -0,0 +1,2 @@
+// @generated by expo-module-scripts
+module.exports = require('expo-module-scripts/eslintrc.base.js');

package/.node-version

@@ -0,0 +1 @@
+v24.12.0

package/.prettierignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+**/node_modules/
+
+# Build outputs
+build/
+dist/
+*.tgz
+
+# iOS
+ios/Pods/
+ios/build/
+*.xcworkspace
+*.xcodeproj
+
+# Android
+android/build/
+android/.gradle/
+android/.idea/
+*.iml
+
+# Generated files
+*.generated.*
+.expo/
+.expo-shared/
+
+# Lock files
+package-lock.json
+yarn.lock
+bun.lock
+pnpm-lock.yaml

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false
+}

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+### 🎉 New features
+### 🐛 Bug fixes
+### 💡 Others
+
+_This version does not introduce any user-facing changes._
+
+## 0.1.0 - 2026-01-06
+
+_Initial release with all features documented in README.md_

package/CONTRIBUTING.md

@@ -0,0 +1,271 @@
+# Contributing to @kishannareshpal/expo-pdf
+
+Thank you for your interest in contributing to `@kishannarehpal/expo-pdf`! This document provides guidelines and instructions for contributing to the project.
+
+## Table of Contents
+
+- [Contributing to @kishannareshpal/expo-pdf](#contributing-to-kishannareshpalexpo-pdf)
+  - [Table of Contents](#table-of-contents)
+  - [Code of Conduct](#code-of-conduct)
+  - [Getting Started](#getting-started)
+  - [Development Setup](#development-setup)
+    - [Prerequisites](#prerequisites)
+    - [Installation](#installation)
+    - [Edit the module source code](#edit-the-module-source-code)
+      - [TypeScript](#typescript)
+      - [Android](#android)
+      - [iOS](#ios)
+      - [Resources](#resources)
+    - [Running the Example App](#running-the-example-app)
+    - [Code Style Guidelines](#code-style-guidelines)
+  - [Testing](#testing)
+    - [Manual Testing](#manual-testing)
+  - [Submitting Changes](#submitting-changes)
+    - [Before Submitting](#before-submitting)
+    - [Pull Request Process](#pull-request-process)
+    - [Pull Request Guidelines](#pull-request-guidelines)
+  - [Reporting Bugs](#reporting-bugs)
+  - [Requesting Features](#requesting-features)
+  - [Questions?](#questions)
+
+## Code of Conduct
+
+This project adheres to a code of conduct that all contributors are expected to follow. Please be respectful and constructive in all interactions.
+
+## Getting Started
+
+Before you begin:
+
+1. **Fork the repository** on GitHub
+2. **Clone your fork** locally:
+   ```bash
+   git clone https://github.com/your-username/expo-pdf.git
+   cd expo-pdf
+   ```
+3. **Add the upstream repository**:
+   ```bash
+   git remote add upstream https://github.com/kishannareshpal/expo-pdf.git
+   ```
+
+## Development Setup
+
+### Prerequisites
+
+- **bun** (https://bun.com/)
+- **For iOS development**:
+  - macOS (required)
+  - Xcode (latest stable version)
+  - CocoaPods: `sudo gem install cocoapods`
+- **For Android development**:
+  - Android Studio
+  - Android SDK and build tools
+  - Java Development Kit (JDK)
+
+### Installation
+
+1. **Install root dependencies**:
+
+   ```bash
+   bun install
+   ```
+2. **Install example app dependencies**:
+
+   ```bash
+   cd example
+   bun install
+   ```
+
+### Edit the module source code
+
+#### TypeScript
+
+Edit the React Native binding TypeScript files from `src/` using your favorite editor, such as VS Code.
+
+#### Android
+
+Edit the Android native files by opening Android Studio: `bun open:android`
+
+![](./docs/contributing-android.png)
+
+#### iOS
+
+Edit the iOS native files by opening Xcode: `bun open:ios`
+
+![](./docs/contributing-ios.png)
+
+#### Resources
+
+The following resources may be helpful as they represent the core of the project:
+
+- [`Expo Modules API` documentation](https://docs.expo.dev/modules/module-api/)
+- [`Apple PDFKit` documentation](https://developer.apple.com/documentation/pdfkit)
+- [`AndroidX PDF` documentation](https://developer.android.com/jetpack/androidx/releases/pdf)
+
+### Running the Example App
+
+The `example/` directory contains a test app to develop and test the changes you make in the module. For example, if you make a change to either the Android / iOS native module, you will need to re-build and re-install the app on the device - this can be easily achieved by following:
+
+1. Start the Metro bundler (if not already):
+
+   ```bash
+   cd example
+   bun start
+   ```
+2. Install and run the app on iOS:
+
+   ```bash
+   cd example
+   bun ios
+   ```
+3. Install and run the app on Android:
+
+   ```bash
+   cd example
+   bun android
+   ```
+
+### Code Style Guidelines
+
+1. **TypeScript/React**:
+
+   - Use functional components with hooks
+   - Prefer `const` over `let` when possible
+   - Use meaningful, self-documenting variable and function names
+   - Add TSDoc comments for public APIs when necessary
+2. **Swift**:
+
+   - Follow Swift style guide conventions
+   - Use meaningful, self-documenting names for classes, functions, and variables
+   - Add documentation comments for public APIs
+3. **Kotlin**:
+
+   - Follow Kotlin style guide conventions
+   - Use meaningful names for classes, functions, and variables
+   - Add KDoc comments for public APIs
+4. **General**:
+
+   - Keep functions focused and small
+   - Write self-documenting code
+   - Comment complex logic
+   - Maintain consistency with existing codebase
+
+## Testing
+
+### Manual Testing
+
+1. Use the example app to manually test your changes
+2. Test on both iOS and Android platforms
+
+## Submitting Changes
+
+### Before Submitting
+
+1. **Update the CHANGELOG.md**:
+
+   - Add your changes under the appropriate version
+   - Use the following format:
+     - `### 🎉 New features` for new features
+     - `### 🐛 Bug fixes` for bug fixes
+     - `### 💡 Others` for other changes
+     - `### 🛠 Breaking changes` for breaking changes
+2. **Test your changes**:
+
+   - Test on iOS
+   - Test on Android
+   - Verify the example app works correctly
+
+### Pull Request Process
+
+1. **Create a branch** from `main`:
+
+   ```bash
+   git checkout -b feature/your-feature-name
+   # or
+   git checkout -b username/your-bug-fix
+   ```
+2. **Make your changes**:
+
+   - Write clean, well-documented code
+   - Follow existing code patterns
+   - Add tests if applicable
+   - Update documentation as needed
+3. **Commit your changes**:
+
+   ```bash
+   git add .
+   git commit -m "feat: add support for password-protected PDFs"
+   ```
+
+   Use conventional commit messages:
+
+   - `feat:` for new features
+   - `fix:` for bug fixes
+   - `docs:` for documentation changes
+   - `style:` for formatting changes
+   - `refactor:` for code refactoring
+   - `test:` for adding tests
+   - `chore:` for maintenance tasks
+4. **Push to your fork**:
+
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+5. **Create a Pull Request**:
+
+   - Go to the GitHub repository
+   - Click "New Pull Request"
+   - Select your branch
+   - Fill out the PR template with:
+     - Description of changes
+     - Testing performed
+     - Screenshots/videos if applicable
+     - Related issues (if any)
+6. **Respond to feedback**:
+
+   - Address any review comments
+   - Make requested changes
+   - Keep the PR up to date with `main`
+
+### Pull Request Guidelines
+
+- Keep PRs focused and reasonably sized
+- One feature or fix per PR
+- Include a clear description
+- Reference related issues
+- Ensure all CI checks pass
+- Request review when ready
+
+## Reporting Bugs
+
+When reporting bugs, please include:
+
+1. **Description**: Clear description of the issue
+2. **Steps to Reproduce**: Detailed steps to reproduce the bug
+3. **Expected Behavior**: What you expected to happen
+4. **Actual Behavior**: What actually happened
+5. **Environment**:
+   - React Native version
+   - Expo SDK version
+   - iOS/Android version
+   - Device or simulator information
+6. **Screenshots/Videos**: If applicable
+7. **Code Sample**: Minimal code example that reproduces the issue
+
+## Requesting Features
+
+When requesting features, please include:
+
+1. **Use Case**: Why this feature would be useful
+2. **Proposed Solution**: How you envision it working
+3. **Alternatives**: Any alternative solutions you've considered
+4. **Additional Context**: Any other relevant information
+
+## Questions?
+
+Feel free to:
+
+- Open an issue for questions or discussions
+- Start a discussion in the GitHub Discussions tab
+- Contact the maintainer directly
+
+Thank you for contributing to `@kishannareshpal/expo-pdf`! 🎉

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kishan Jadav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,243 @@
+# `@kishannareshpal/expo-pdf`
+
+A cross-platform, high-performance PDF viewer for React Native and Expo, built on top of native PDF rendering engines.
+
+### Core features
+
+- [X] Supports Android and iOS
+  - Uses Apple's [`PDFKit`](https://developer.apple.com/documentation/pdfkit/pdfview) on iOS
+  - Uses [kishannareshpal/AndroidPdfViewer](https://github.com/kishannareshpal/AndroidPdfViewer) on Android which is a maintained
+    fork of [barteksc/AndroidPdfViewerV2](https://github.com/kishannareshpal/AndroidPdfViewer) which uses the open-source [PDFium](https://pdfium.googlesource.com/pdfium/+/HEAD/docs/getting-started.md) PDF rendering engine.
+    - Note: We'll be looking to switch to [`androidx.pdf`](https://developer.android.com/jetpack/androidx/releases/pdf) on Android once that becomes stable.
+- [x] Load PDFs from remote URLs or local file paths
+  - [x] Supports local file URIs on android and iOS and ContentResolver URIs on android.
+  - [x] Remote URLs cannot be passed directly to the PdfView component. You must download it and then use the local file URI to preview.
+- [X] Pinch-to-zoom / double-tap-to-zoom and drag gestures
+- [x] Support for password-protected PDFs
+- [x] Horizontal and vertical reading modes
+- [x] Support for content-insets 
+
+### Demo
+
+| [iOS](./docs/demo-ios.mp4)                                                                      | [Android](./docs/demo-android.mp4)                                                              |
+| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| <video src="https://github.com/user-attachments/assets/6c88deb7-7801-4e3a-b93e-88f9688435a1" /> | <video src="https://github.com/user-attachments/assets/ce9bd00f-0a4e-47ec-800c-cbdcba5c5554" /> |
+
+### Installation
+
+This package works with both Expo and framework-less React Native projects but Expo provides a more streamlined experience.
+
+```
+npm install @kishannareshpal/expo-pdf
+
+# bun add @kishannareshpal/expo-pdf
+# pnpm add @kishannareshpal/expo-pdf
+```
+
+### Usage
+
+#### Use a locally bundled PDF
+
+```jsx
+import { PdfView } from '@kishannareshpal/expo-pdf'
+
+export const App = () => {
+  const [assets] = useAssets([require('./assets/sample.pdf')]);
+  const [uri, setUri] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!assets?.length) {
+      return;
+    }
+
+    assets[0].downloadAsync()
+      .then((asset) => setUri(asset.localUri))
+      .catch(console.error)
+  }, [assets])
+
+  if (!uri) {
+    return null;
+  }
+
+  return (
+    <PdfView 
+      style={{ flex: 1 }} 
+      uri={uri}
+    />
+  )
+}
+```
+
+#### Load a file picked using a system picker
+
+```jsx
+import { File } from 'expo-file-system';
+import * as DocumentPicker from 'expo-document-picker';
+import { PdfView } from '@kishannareshpal/expo-pdf'
+
+export const App = () => {
+  const [uri, setUri] = useState<string | null>(null)
+
+  const pickFile = () => {
+    try {
+      const result = await DocumentPicker.getDocumentAsync({ copyToCacheDirectory: true });
+      const file = new File(result.assets[0]);
+      setUri(file.localUri)
+    } catch (error) {
+      console.error(error);
+    }
+  }
+
+  if (!uri) {
+    return null;
+  }
+
+  return (
+    <View>
+      <Button onPress={pickFile}>Pick a file</Button>
+      
+      <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
+        {uri ? (
+          <PdfView 
+            style={{ flex: 1 }} 
+            uri={uri}
+          />
+        ) : (
+          <Text>Please pick a file<Text>
+        )}
+      </View>
+    </View>
+  )
+}
+```
+
+#### Use remote URLs
+
+```jsx
+import { File } from 'expo-file-system';
+import * as DocumentPicker from 'expo-document-picker';
+import { PdfView } from '@kishannareshpal/expo-pdf'
+
+export const App = () => {
+  const [uri, setUri] = useState<string | null>(null)
+
+  const loadFromUrl = (url: string) => {
+    const destination = new Directory(Paths.cache, 'pdfs');
+
+    try {
+      destination.create();
+      const output = await File.downloadFileAsync(url, destination);
+      setUri(output.uri)
+    } catch (error) {
+      console.error(error);
+    }
+  }
+
+  if (!uri) {
+    return null;
+  }
+
+  return (
+    <View>
+      <Button onPress={() => loadFromUrl("https://pdfobject.com/pdf/sample.pdf")}>
+        Download and load from URL
+      </Button>
+      
+      <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
+        {uri ? (
+          <PdfView 
+            style={{ flex: 1 }} 
+            uri={uri}
+          />
+        ) : (
+          <Text>Please download the file to preview<Text>
+        )}
+      </View>
+    </View>
+  )
+}
+```
+
+### API
+
+| Props                    | Required | Type                                                                  | Description                                            | Default                                    |
+| ------------------------ | -------- | --------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------ |
+| `uri`                    | Required | `string`                                                              | PDF document URL or local file path.                   | -                                          |
+| `password`               | No       | `string`                                                              | PDF document URL or local file path.                   | `undefined`                                |
+| `pagingEnabled`          | No       | `boolean`                                                             | PDF document URL or local file path.                   | `false`                                    |
+| `disableDoubleTapToZoom` | No       | `boolean`                                                             | PDF document URL or local file path.                   | `false`                                    |
+| `horizontal`             | No       | `boolean`                                                             | PDF document URL or local file path.                   | `false`                                    |
+| `pageGap`                | No       | `number`                                                              | PDF document URL or local file path.                   | `0`                                        |
+| `contentPadding`         | No       | [`ContentPadding`](#contentpadding)                                   | PDF document URL or local file path.                   | `{ top: 0, left: 0, right: 0, bottom: 0 }` |
+| `fitMode`                | No       | [`FitMode`](#fitmode)                                                 | PDF document URL or local file path.                   | `"width"`                                  |
+| `onLoadComplete`         | No       | [`(OnLoadCompleteEventPayload) => void`](#onloadcompleteeventpayload) | Triggered once the document has been fully loaded.     | -                                          |
+| `onPageChanged`          | No       | [`(OnPageChangedPayload) => void`](#onpagechangedeventpayload)        | Triggered when the user navigates to a different page. | -                                          |
+| `onError`                | No       | [`(OnErrorPayload) => void`](#onerroreventpayload)                    | Triggered when the PDF fails to load or render.        | -                                          |
+
+
+#### API Reference
+
+##### `ContentPadding`
+
+```ts
+{ top?: number, left?: number, right?: number, bottom?: number }
+```
+
+##### `FitMode`
+
+```ts
+"width" | "height" | "both"
+```
+
+##### `OnLoadCompleteEventPayload`
+
+```ts
+{ pageCount: number }
+```
+
+##### `OnPageChangedEventPayload`
+
+```ts
+{ pageIndex: number, pageCount: number }
+```
+
+##### `OnErrorEventPayload`
+
+```ts
+{
+    code: 'invalid_url' | 'invalid_document' | 'password_required' | 'password_incorrect', 
+    message: string
+}
+```
+
+### Contributing
+
+Contributions are welcome!
+
+#### How to contribute
+
+Please read [CONTRIBUTING.md](./CONTRIBUTING.md)
+
+#### Publishing a new version to the registry
+
+> [!NOTE]
+>
+> This package follows semantic versioning with the format: `major.minor.patch`.
+> - Major version: Increment when making incompatible API changes.
+> - Minor version: Increment when adding new functionality in a backward-compatible way.
+> - Patch version: Increment when fixing bugs in a backward-compatible manner.
+****
+1. Bump `package.json` version using one of `npm version patch|minor|major` - this will create a new `tag`.
+2. `git push --tags` to push the new changes including the newly created tag.
+3. Navigate to [Create a New Release](https://github.com/kishannareshpal/expo-pdf/releases/new)
+4. Select the latest tag you've created above.
+5. Use the same name as the tag for the release title.
+6. Click <kbd>Generate release notes</kbd>, and/or edit the description to detail the changes.
+7. Click the green <kbd>Publish release</kbd> button.
+8. A GitHub action will automatically run to publish the new version of the package to the registry.
+   - Monitor the status at [kishannareshpal/expo-pdf/actions](https://github.com/kishannareshpal/expo-pdf/actions)
+
+
+### License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,55 @@
+apply plugin: 'com.android.library'
+
+group = 'com.kishannareshpal.expopdf'
+version = '0.1.0'
+
+def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+apply from: expoModulesCorePlugin
+applyKotlinExpoModulesCorePlugin()
+useCoreDependencies()
+useExpoPublishing()
+
+// If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
+// The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
+// Most of the time, you may like to manage the Android SDK versions yourself.
+def useManagedAndroidSdkVersions = false
+if (useManagedAndroidSdkVersions) {
+  useDefaultAndroidSdkVersions()
+} else {
+  buildscript {
+    // Simple helper that allows the root project to override versions declared by this library.
+    ext.safeExtGet = { prop, fallback ->
+      rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
+  }
+  project.android {
+    compileSdkVersion safeExtGet("compileSdkVersion", 36)
+    defaultConfig {
+      minSdkVersion safeExtGet("minSdkVersion", 24)
+      targetSdkVersion safeExtGet("targetSdkVersion", 36)
+    }
+  }
+}
+
+android {
+  namespace "com.kishannareshpal.expopdf"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}
+
+dependencies {
+  // NOTE: The original repo at com.github.barteksc is abandoned by the maintainer; there will be no
+  //       more updates coming from that repo.
+  //       - com.github.kishannareshpal:AndroidPdfViewer repo is based on PdfiumAndroidKt, a much newer
+  //       fork of PdfiumAndroid, with better maintenance and updated native libraries.
+  implementation 'com.github.kishannareshpal:AndroidPdfViewer:2026.01.05.5'
+
+  // Explicitly define the version of PdfiumAndroidKt so this can be updated independently of
+  // AndroidPdfViewer as updates are provided.
+  implementation 'io.legere:pdfiumandroid:1.0.35'
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<manifest xmlns:tools="http://schemas.android.com/tools">
+    <uses-sdk tools:overrideLibrary="
+        androidx.pdf,
+        androidx.pdf.document.service,
+        androidx.pdf.viewer,
+        androidx.pdf.viewer.fragment,
+        androidx.pdf.models,
+        androidx.pdf.util" />
+</manifest>

package/android/src/main/java/com/kishannareshpal/expopdf/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false