@kishannareshpal/expo-pdf 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -1,13 +1,35 @@
 # Changelog
 
-## Unpublished
+<!--
+## x.y.z - YYYY-MM-DD
 
 ### 🛠 Breaking changes
+- [ios|android] Describe change or paste PR title (<link to pr or if commit if no pr> by @username)
+
 ### 🎉 New features
 ### 🐛 Bug fixes
 ### 💡 Others
 
 _This version does not introduce any user-facing changes._
+-->
+
+## 0.2.1 - 2026-01-09
+
+_This version does not introduce any user-facing changes._
+
+### 💡 Others
+
+- Reduce package size by removing lock files from the package bundle (https://github.com/kishannareshpal/expo-pdf/commit/f9be18c by @kishannareshpal)
+
+## 0.2.0 - 2026-01-09
+
+### 🎉 New features
+
+- Add support for the `autoScale` prop to control scaling on view resize (https://github.com/kishannareshpal/expo-pdf/pull/5 by @kishannareshpal)
+
+### 💡 Others
+
+- Added a new example for bottom sheet to showcase the use of the new `autoScale` prop (https://github.com/kishannareshpal/expo-pdf/pull/6 by @kishannareshpal)
 
 ## 0.1.0 - 2026-01-06
 

package/CONTRIBUTING.md

@@ -2,56 +2,33 @@
 
 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.
+Please be respectful and constructive in all interactions.
 
 ## Getting Started
 
 Before you begin:
 
-1. **Fork the repository** on GitHub
-2. **Clone your fork** locally:
+1. Fork and clone the repo:
    ```bash
    git clone https://github.com/your-username/expo-pdf.git
    cd expo-pdf
    ```
-3. **Add the upstream repository**:
+2. Add the upstream repository:
    ```bash
    git remote add upstream https://github.com/kishannareshpal/expo-pdf.git
    ```
+3. Install dependencies
+   ```bash
+   bun install
+   ```
 
 ## Development Setup
 
 ### Prerequisites
 
-- **bun** (https://bun.com/)
+- **bun** (https://bun.com)
 - **For iOS development**:
   - macOS (required)
   - Xcode (latest stable version)
@@ -68,6 +45,7 @@ Before you begin:
    ```bash
    bun install
    ```
+
 2. **Install example app dependencies**:
 
    ```bash
@@ -111,12 +89,14 @@ The `example/` directory contains a test app to develop and test the changes you
    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
@@ -127,23 +107,19 @@ The `example/` directory contains a test app to develop and test the changes you
 ### 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
@@ -161,7 +137,6 @@ The `example/` directory contains a test app to develop and test the changes you
 ### Before Submitting
 
 1. **Update the CHANGELOG.md**:
-
    - Add your changes under the appropriate version
    - Use the following format:
      - `### 🎉 New features` for new features
@@ -169,7 +144,6 @@ The `example/` directory contains a test app to develop and test the changes you
      - `### 💡 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
@@ -183,12 +157,13 @@ The `example/` directory contains a test app to develop and test the changes you
    # or
    git checkout -b username/your-bug-fix
    ```
-2. **Make your changes**:
 
+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
@@ -197,7 +172,6 @@ The `example/` directory contains a test app to develop and test the changes you
    ```
 
    Use conventional commit messages:
-
    - `feat:` for new features
    - `fix:` for bug fixes
    - `docs:` for documentation changes
@@ -205,13 +179,14 @@ The `example/` directory contains a test app to develop and test the changes you
    - `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**:
 
+5. **Create a Pull Request**:
    - Go to the GitHub repository
    - Click "New Pull Request"
    - Select your branch
@@ -220,8 +195,8 @@ The `example/` directory contains a test app to develop and test the changes you
      - Testing performed
      - Screenshots/videos if applicable
      - Related issues (if any)
-6. **Respond to feedback**:
 
+6. **Respond to feedback**:
    - Address any review comments
    - Make requested changes
    - Keep the PR up to date with `main`

package/README.md

@@ -1,74 +1,87 @@
 # `@kishannareshpal/expo-pdf`
 
+![NPM Version](https://img.shields.io/npm/v/%40kishannareshpal%2Fexpo-pdf?style=flat&logo=npm&label=%40kishannareshpal%2Fexpo-pdf)
+![GitHub Repo stars](https://img.shields.io/github/stars/kishannareshpal/expo-pdf?style=flat)
+
 A cross-platform, high-performance PDF viewer for React Native and Expo, built on top of native PDF rendering engines.
 
-### Core features
+| [iOS](./docs/demo-ios.mp4)                                                                      | [Android](./docs/demo-android.mp4)                                                              |
+| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| <video src="https://github.com/user-attachments/assets/57000914-4f7a-4139-9079-9cfd8ece740b" /> | <video src="https://github.com/user-attachments/assets/14faf4f1-b7cc-4e8b-97a5-c0da94fd26c2" /> |
+
+## Features
 
-- [X] Supports Android and iOS
+- 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" /> |
+- Load PDFs from remote URLs or local file paths
+  - Supports local file URIs on android and iOS and ContentResolver URIs on android.
+  - Remote URLs cannot be passed directly to the PdfView component. You must download it and then use the local file URI to preview.
+- Pinch-to-zoom / double-tap-to-zoom and drag gestures
+- Support for password-protected PDFs
+- Horizontal and vertical reading modes
+- Support for content-insets
 
-### Installation
+## 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
+### Expo
 
-# bun add @kishannareshpal/expo-pdf
-# pnpm add @kishannareshpal/expo-pdf
+```bash
+npx expo install @kishannareshpal/expo-pdf
 ```
 
-### Usage
+### Bare React Native
+
+1. Install this package
+
+   ```bash
+   npm add @kishannareshpal/expo-pdf
+
+   # bun add @kishannareshpal/expo-pdf
+   # pnpm add @kishannareshpal/expo-pdf
+   # yarn add @kishannareshpal/expo-pdf
+   ```
 
-#### Use a locally bundled PDF
+2. Install CocoaPods dependencies
+   ```bash
+   npx pod-install
+   ```
+
+## Usage
+
+### Use a locally bundled PDF
 
 ```jsx
-import { PdfView } from '@kishannareshpal/expo-pdf'
+import { PdfView } from '@kishannareshpal/expo-pdf';
 
 export const App = () => {
   const [assets] = useAssets([require('./assets/sample.pdf')]);
-  const [uri, setUri] = useState<string | null>(null);
+  const [uri, setUri] = (useState < string) | (null > null);
 
   useEffect(() => {
     if (!assets?.length) {
       return;
     }
 
-    assets[0].downloadAsync()
+    assets[0]
+      .downloadAsync()
       .then((asset) => setUri(asset.localUri))
-      .catch(console.error)
-  }, [assets])
+      .catch(console.error);
+  }, [assets]);
 
   if (!uri) {
     return null;
   }
 
-  return (
-    <PdfView 
-      style={{ flex: 1 }} 
-      uri={uri}
-    />
-  )
-}
+  return <PdfView style={{ flex: 1 }} uri={uri} />;
+};
 ```
 
-#### Load a file picked using a system picker
+### Load a file picked using a system picker
 
 ```jsx
 import { File } from 'expo-file-system';
@@ -95,11 +108,11 @@ export const App = () => {
   return (
     <View>
       <Button onPress={pickFile}>Pick a file</Button>
-      
+
       <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
         {uri ? (
-          <PdfView 
-            style={{ flex: 1 }} 
+          <PdfView
+            style={{ flex: 1 }}
             uri={uri}
           />
         ) : (
@@ -111,7 +124,7 @@ export const App = () => {
 }
 ```
 
-#### Use remote URLs
+### Use remote URLs
 
 ```jsx
 import { File } from 'expo-file-system';
@@ -142,11 +155,11 @@ export const App = () => {
       <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 }} 
+          <PdfView
+            style={{ flex: 1 }}
             uri={uri}
           />
         ) : (
@@ -158,75 +171,164 @@ export const App = () => {
 }
 ```
 
-### 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`
+## API
+
+<table>
+   <thead>
+      <tr>
+         <th>Props</th>
+         <th>Required</th>
+         <th>Type</th>
+         <th>Description</th>
+         <th>Default</th>
+      </tr>
+   </thead>
+   <tbody>
+      <tr>
+         <td><code>uri</code></td>
+         <td>Required</td>
+         <td><code>string</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td>-</td>
+      </tr>
+      <tr>
+         <td><code>password</code></td>
+         <td>No</td>
+         <td><code>string</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>undefined</code></td>
+      </tr>
+      <tr>
+         <td><code>pagingEnabled</code></td>
+         <td>No</td>
+         <td><code>boolean</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>false</code></td>
+      </tr>
+      <tr>
+         <td><code>doubleTapToZoom</code></td>
+         <td>No</td>
+         <td><code>boolean</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>true</code></td>
+      </tr>
+      <tr>
+         <td><code>horizontal</code></td>
+         <td>No</td>
+         <td><code>boolean</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>false</code></td>
+      </tr>
+      <tr>
+         <td><code>pageGap</code></td>
+         <td>No</td>
+         <td><code>number</code></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>0</code></td>
+      </tr>
+      <tr>
+         <td><code>contentPadding</code></td>
+         <td>No</td>
+         <td><a href="#contentpadding"><code>ContentPadding</code></a></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>{ top: 0, left: 0, right: 0, bottom: 0 }</code></td>
+      </tr>
+      <tr>
+         <td><code>fitMode</code></td>
+         <td>No</td>
+         <td><a href="#fitmode"><code>FitMode</code></a></td>
+         <td>PDF document URL or local file path.</td>
+         <td><code>"width"</code></td>
+      </tr>
+      <tr>
+         <td><code>autoScale</code></td>
+         <td>No</td>
+         <td><code>boolean</code></td>
+         <td>
+            Whether the document should auto-scale when itself or its parent view changes its layout metrics. 
+            Please note that the initial render will always auto-scale to fit whatever <code>fitMode</code> is set to. 
+            This prop only affects subsequent layout changes.</td>
+         <td><code>true</code></td>
+      </tr>
+      <tr>
+         <td><code>onLoadComplete</code></td>
+         <td>No</td>
+         <td><a href="#onloadcompleteeventpayload"><code>(OnLoadCompleteEventPayload) =&gt; void</code></a></td>
+         <td>Triggered once the document has been fully loaded.</td>
+         <td>-</td>
+      </tr>
+      <tr>
+         <td><code>onPageChanged</code></td>
+         <td>No</td>
+         <td><a href="#onpagechangedeventpayload"><code>(OnPageChangedPayload) =&gt; void</code></a></td>
+         <td>Triggered when the user navigates to a different page.</td>
+         <td>-</td>
+      </tr>
+      <tr>
+         <td><code>onError</code></td>
+         <td>No</td>
+         <td><a href="#onerroreventpayload"><code>(OnErrorPayload) =&gt; void</code></a></td>
+         <td>Triggered when the PDF fails to load or render.</td>
+         <td>-</td>
+      </tr>
+   </tbody>
+</table>
+
+### API Reference
+
+#### `ContentPadding`
 
 ```ts
 { top?: number, left?: number, right?: number, bottom?: number }
 ```
 
-##### `FitMode`
+#### `FitMode`
 
 ```ts
-"width" | "height" | "both"
+'width' | 'height' | 'both';
 ```
 
-##### `OnLoadCompleteEventPayload`
+#### `OnLoadCompleteEventPayload`
 
 ```ts
-{ pageCount: number }
+{
+  pageCount: number;
+}
 ```
 
-##### `OnPageChangedEventPayload`
+#### `OnPageChangedEventPayload`
 
 ```ts
 { pageIndex: number, pageCount: number }
 ```
 
-##### `OnErrorEventPayload`
+#### `OnErrorEventPayload`
 
 ```ts
 {
-    code: 'invalid_url' | 'invalid_document' | 'password_required' | 'password_incorrect', 
+    code: 'invalid_url' | 'invalid_document' | 'password_required' | 'password_incorrect',
     message: string
 }
 ```
 
-### Contributing
+## Contributing
 
 Contributions are welcome!
 
-#### How to contribute
+### How to contribute
 
 Please read [CONTRIBUTING.md](./CONTRIBUTING.md)
 
-#### Publishing a new version to the registry
+### How to publish a new version to the registry
 
-> [!NOTE]
+> **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)
@@ -237,7 +339,6 @@ Please read [CONTRIBUTING.md](./CONTRIBUTING.md)
 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
+## License
 
 MIT

package/android/build.gradle

@@ -47,7 +47,7 @@ dependencies {
   //       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'
+  implementation 'com.github.kishannareshpal:AndroidPdfViewer:2026.01.07.2'
 
   // Explicitly define the version of PdfiumAndroidKt so this can be updated independently of
   // AndroidPdfViewer as updates are provided.

package/android/src/main/java/com/kishannareshpal/expopdf/KJExpoPdfModule.kt

@@ -36,8 +36,8 @@ class KJExpoPdfModule : Module() {
         view.setPagingEnabled(enabled)
       }
 
-      Prop("disableDoubleTapToZoom") { view: KJExpoPdfView, disabled: Boolean? ->
-        view.setDoubleTapZoomEnabled(disabled != true)
+      Prop("doubleTapToZoom") { view: KJExpoPdfView, enabled: Boolean? ->
+        view.setDoubleTapZoomEnabled(enabled)
       }
 
       Prop("horizontal") { view: KJExpoPdfView, enabled: Boolean? ->
@@ -55,6 +55,10 @@ class KJExpoPdfModule : Module() {
       Prop("fitMode") { view: KJExpoPdfView, mode: FitMode? ->
         view.setFitMode(mode)
       }
+
+      Prop("autoScale") { view: KJExpoPdfView, enabled: Boolean? ->
+         view.setAutoScaleEnabled(enabled)
+      }
     }
   }
 }

package/android/src/main/java/com/kishannareshpal/expopdf/KJExpoPdfView.kt

@@ -10,17 +10,16 @@ import com.github.barteksc.pdfviewer.PDFView
 import expo.modules.kotlin.viewevent.EventDispatcher
 import java.io.FileNotFoundException
 import androidx.core.net.toUri
-import com.github.barteksc.pdfviewer.util.FitPolicy
+import com.github.barteksc.pdfviewer.util.SnapEdge
 import com.kishannareshpal.expopdf.lib.FitMode
 
-// TODO: Refresh the content on prop change
-
 class KJExpoPdfView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
   companion object {
-    internal val DEFAULT_PAGING_ENABLED = false
-    internal val DEFAULT_DOUBLE_TAP_ZOOM_ENABLED = true
-    internal val DEFAULT_HORIZONTAL_MODE_ENABLED = false
-    internal val DEFAULT_PAGE_GAP = 0
+    internal const val DEFAULT_PAGING_ENABLED = false
+    internal const val DEFAULT_DOUBLE_TAP_ZOOM_ENABLED = true
+    internal const val DEFAULT_HORIZONTAL_MODE_ENABLED = false
+    internal const val DEFAULT_PAGE_GAP = 0
+    internal const val DEFAULT_AUTO_SCALE_ENABLED = true
     internal val DEFAULT_CONTENT_PADDING = Rect(0, 0, 0, 0)
     internal val DEFAULT_FIT_MODE = FitMode.both
   }
@@ -44,6 +43,7 @@ class KJExpoPdfView(context: Context, appContext: AppContext) : ExpoView(context
   private var pageGap: Int = DEFAULT_PAGE_GAP
   private var contentPadding: Rect = DEFAULT_CONTENT_PADDING
   private var fitMode: FitMode = DEFAULT_FIT_MODE
+  private var autoScaleEnabled: Boolean = DEFAULT_AUTO_SCALE_ENABLED
 
   internal val pdfView = PDFView(context, null).apply {
     layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
@@ -104,12 +104,7 @@ class KJExpoPdfView(context: Context, appContext: AppContext) : ExpoView(context
   }
 
   fun setContentPadding(rect: Rect?) {
-    this.contentPadding = if (rect != null) {
-      Rect(rect.left, rect.top, rect.right, rect.bottom)
-    } else {
-      DEFAULT_CONTENT_PADDING
-    }
-
+    this.contentPadding = rect ?: DEFAULT_CONTENT_PADDING
     this.reloadPdf()
   }
 
@@ -118,6 +113,11 @@ class KJExpoPdfView(context: Context, appContext: AppContext) : ExpoView(context
     this.reloadPdf()
   }
 
+  fun setAutoScaleEnabled(enabled: Boolean?) {
+    this.autoScaleEnabled = enabled ?: DEFAULT_AUTO_SCALE_ENABLED
+    this.reloadPdf()
+  }
+
   private fun reloadPdf() {
     if (!this.pdfView.isRecycled) {
       this.pdfView.recycle()
@@ -144,6 +144,7 @@ class KJExpoPdfView(context: Context, appContext: AppContext) : ExpoView(context
       .enableDoubletap(this.isDoubleTapZoomEnabled)
       .swipeHorizontal(this.isHorizontalModeEnabled)
       .spacing(this.pageGap)
+      .autoCenterOnResize(this.autoScaleEnabled)
       .contentPadding(
         this.contentPadding.left,
         this.contentPadding.top,