pdfrx
This repository contains multiple Dart/Flutter packages for PDF rendering, viewing, and manipulation:
Requirements
- Dart packages require Dart 3.13 or later.
- Flutter packages require Flutter 3.47 or later.
- Apple platform integrations target iOS 15 or later and macOS 12 or later.
Packages
A platform-agnostic PDF rendering and manipulation API built on top of PDFium.
- Pure Dart package (no Flutter dependencies)
- Provides low-level PDF document API for viewing and editing
- Supports page re-arrangement, PDF combining, image import, and document manipulation
- Can be used in CLI applications or non-Flutter Dart projects
- Supports all platforms: Android, iOS, Windows, macOS, Linux
View repo | API reference
A cross-platform PDF viewer and manipulation plugin for Flutter.
- Flutter plugin with UI widgets
- Built on top of pdfrx_engine
- Provides high-level viewer widgets and overlays
- Includes text selection, search, zoom controls, and more
- Supports PDF editing features like page manipulation, document combining, and image import
View repo | API reference
⚠️ EXPERIMENTAL - CoreGraphics-backed renderer for pdfrx on iOS/macOS.
- Uses PDFKit/CoreGraphics instead of PDFium on Apple platforms
- Drop-in replacement for teams preferring the system PDF stack
- Maintains full compatibility with pdfrx widget API
- iOS and macOS only
View repo | API reference
Low-level Dart FFI bindings for the PDFium library.
- Pure Dart package with auto-generated FFI bindings using ffigen
- Provides direct access to PDFium's C API from Dart
- Provides PDFium as a Dart native asset, downloaded and bundled at build time
- Includes getPdfium() for resolving PDFium from a custom module path, Flutter-packaged library, or bundled native asset
- Coordinates with
pdfium_flutter so iOS/macOS Flutter apps use the PDFium XCFramework instead of bundling a duplicate dylib
- Used as a foundation by higher-level packages
View repo | API reference
Flutter FFI plugin for PDFium integration on native Flutter platforms.
- Supports Android, iOS, Windows, macOS, and Linux
- Provides the platform packaging needed to deploy PDFium in Flutter apps
- Uses Dart native assets for Android, Linux, and Windows
- Uses the iOS/macOS PDFium XCFramework through CocoaPods or Swift Package Manager
- Includes low-level PDFium FFI bindings
View repo | API reference
When to Use Which Package
- Use pdfrx if you're building a Flutter application and need PDF viewing and manipulation capabilities with UI
- Use pdfrx_engine if you need PDF rendering and manipulation without Flutter dependencies (e.g., server-side PDF processing, CLI tools, PDF combining utilities)
- Use pdfrx_coregraphics (experimental) if you want to use CoreGraphics/PDFKit instead of PDFium on iOS/macOS
- Use pdfium_flutter if you're building Flutter apps or plugins that need direct PDFium access on native platforms
- Use pdfium_dart if you need low-level PDFium FFI bindings for pure Dart projects
Getting Started
For Flutter Applications
Add pdfrx to your pubspec.yaml:
dependencies:
pdfrx: ^2.6.5
For Pure Dart Applications
Add pdfrx_engine to your pubspec.yaml:
dependencies:
pdfrx_engine: ^0.6.1
Documentation
Comprehensive documentation is available in the doc/ directory, including:
- Getting started guides
- Feature tutorials
- Platform-specific configurations
- Code examples
Development
This is a monorepo managed with pub workspaces. Just do dart pub get on some directory inside the repo to obtain all the dependencies.
Example Applications
PDF Viewer
The example viewer application is located in packages/pdfrx/example/viewer/. It demonstrates the full capabilities of the pdfrx Flutter plugin.
cd packages/pdfrx/example/viewer
flutter run
PDF Combine
The packages/pdfrx/example/pdf_combine/ application demonstrates PDF page manipulation and combining features:
- Drag-and-drop interface for page re-arrangement
- Visual thumbnails of PDF pages
- Support for combining multiple PDF documents
- Platform file drag-and-drop support
cd packages/pdfrx/example/pdf_combine
flutter run
Contributing
Contributions are welcome! Please read the individual package READMEs for specific development guidelines.
License
This project is licensed under the MIT License - see the LICENSE file for details.
