PDFLince

KO | EN

gitlite — search

#php #javascript #python #ruby #java #linux #library #ios #objective-c #html #jquery #dotfiles

★ 51 Open GitHub ↗

The privacy-first, client-side PDF toolkit. Compress, Merge, Split, Reorder and Convert PDFs entirely in your browser without server uploads.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# PDFLince

**The Privacy-First Client-Side PDF Toolkit.**

[![Official Website](https://img.shields.io/badge/Website-pdflince.com-blue?style=for-the-badge&logo=google-chrome)](https://pdflince.com/en?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Build Status](https://github.com/GSiesto/pdflince/actions/workflows/deploy.yml/badge.svg?style=for-the-badge)](https://github.com/GSiesto/pdflince/actions)

| Language | Link |
| :--- | :--- |
| 🇬🇧 English | [pdflince.com/en](https://pdflince.com/en?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇪🇸 Español | [pdflince.com](https://pdflince.com/?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇫🇷 Français | [pdflince.com/fr](https://pdflince.com/fr?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇩🇪 Deutsch | [pdflince.com/de](https://pdflince.com/de?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇵🇹 Português | [pdflince.com/pt](https://pdflince.com/pt?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇮🇹 Italiano | [pdflince.com/it](https://pdflince.com/it?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇷🇴 Română | [pdflince.com/ro](https://pdflince.com/ro?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇷🇺 Русский | [pdflince.com/ru](https://pdflince.com/ru?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |
| 🇭🇺 Magyar | [pdflince.com/hu](https://pdflince.com/hu?utm_source=github&utm_medium=readme&utm_campaign=pdflince_public) |

## Why PDFLince?

Most online PDF tools require you to upload your sensitive documents to their cloud servers for processing. This creates privacy risks and compliance issues.

**PDFLince is different:**
- **Zero Server Uploads**: All logic runs in your browser via `pdf-lib` and Web Workers.
- **Privacy by Design**: Ideal for contracts, bank statements, and personal data.
- **Offline Capable**: Works even without an internet connection once loaded.
- **No File Size Limits**: Bypasses server payload limits since it uses your device's memory.

## Features

- **Compress**: Smart compression with adaptive image downscaling (WebWorker-powered).
- **Merge**: Combine multiple PDFs into one document.
- **Split**: Extract ranges or split every page into separate files.
- **Convert**: PDF to Image (JPG, PNG) and Image to PDF.
- **Organize**: Extract pages, reorder pages, and delete pages visually.
- **Crop**: Crop PDF pages manually with visual selection or by specifying precise values
- **Rotate**: Rotate selected pages and preview changes in real-time before exporting.
- **Secure**: 100% local processing verifiable via Network tab.
- **Multilingual**: Native support for 9 languages (English, Spanish, French, German, Portuguese, Italian, Romanian, Russian, Hungarian).

## Architecture

Built with a focus on performance and code quality. The key differentiator is the **Zero-Server Data Flow**:

```mermaid
graph TD
    User["👤 User"] -->|1. Select PDF| UI["💻 Browser UI (Next.js)"]
    UI -->|2. Offload work| Worker["⚙️ Web Worker"]
    
    subgraph Client ["🔒 Client-Side (Your Device)"]
        UI
        Worker
        Engine["📦 PDF-lib / PDF.js"]
        Worker -->|3. Process| Engine
        Engine -->|4. Result| Worker
    end
    
    subgraph Cloud ["☁️ Static Hosting"]
        CDN["AWS CloudFront / S3"]
        CDN -->|0. Load App Code| UI
    end
    
    Worker -->|5. Blob URL| Download["📂 Download File"]
    
    %% Privacy Barrier
    linkStyle 4 stroke:green,stroke-width:2px;
    
    style Client fill:#e6fffa,stroke:#00b894,stroke-width:2px
    style Cloud fill:#dfe6e9,stroke:#636e72,stroke-dasharray: 5 5
```

- **Framework**: [Next.js 15](https://nextjs.org/) (App Router, Static Export).
- **Core Engine**: [pdf-lib](https://pdf-lib.js.org/) & [PDF.js](https://mozilla.github.io/pdf.js/).
- **Concurrency**: Web Workers for non-blocking UI during heavy compression tasks.
- **Styling**: Tailwind CSS with a custom design system.
- **Testing**: Playwright End-to-End test suite ensuring reliability across all operations.

## Local Development

### Prerequisites
- Bun 1.0+

### Quick Start

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/GSiesto/pdflince.git
    cd pdflince
    ```

2.  **Install dependencies:**
    ```bash
    bun install
    ```

3.  **Run development server:**
    ```bash
    bun run dev
    ```

4.  **Open in browser:**
    Navigate to [http://localhost:3000](http://localhost:3000).

## Contributing

Contributions are welcome! Whether it's fixing bugs, improving documentation, or proposing new features.

Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before getting started.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## About the Name

"Lince" means **Lynx** in Spanish. The **Iberian Lynx** (*Lynx pardinus*) is a wild cat species native to the Iberian Peninsula (Spain/Portugal). It was once the most endangered feline species in the world, but conservation efforts are helping its population recover.

Just like the lynx, this tool is fast, sharp, and native to its environment (your browser). 🐱

PDFLince

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README