Offline PDF Utility

An AI-coded, completely offline PDF toolkit built with React and TypeScript, featuring a stunning glassmorphism UI. Perform all PDF operations securely in your browser with complete privacy.

App Interface

Features

• 100% Offline: Your files are never uploaded to a server, ensuring maximum privacy and security.
• Modern UI: A beautiful and intuitive glassmorphism interface built with the Lovable UI framework.
• Split PDF: Extract specific pages or page ranges from a PDF.
• Merge PDF: Combine multiple PDF documents into a single file.
• Unlock PDF: Remove password protection from encrypted PDF files.
• Edit Metadata: Modify your PDF's title, author, subject, and keywords.
• Convert to PDF: Convert JPEG, PNG, or DOCX files to PDF format.
• Add Watermark: Apply a text watermark to every page of your PDF.

How to Use

This tool is designed to be simple and intuitive. All processing happens directly in your browser, ensuring your files remain private.

1. Open the Application: Access the PDF Utility through the provided live URL or by running it locally (see Setup and Development).
2. Choose a Tool: From the main dashboard, click on the tool you need, such as "Split PDF" or "Add Watermark".
3. Follow the Steps: Each tool will present you with simple options. This usually involves:
   • Uploading your PDF or image file(s).
   • Filling in any required fields (like page numbers for splitting or text for a watermark).
4. Process Your File: Click the main action button for the tool.
5. Download Your File: Your new, modified file will be automatically downloaded by your browser.

That's it! No complex steps, just a straightforward tool for your PDF needs.

Offline Usage (No Internet Required)

For a truly offline experience, you can run this application without any internet connection, not even for the first time.

For Developers (Creating the Offline Version)

1. Build the application:

   npm run build

2. Package the files: This will create a dist folder containing all the necessary files. Compress this dist folder into a .zip file (e.g., offline-pdf-utility.zip).

For End-Users

1. Download and Unzip: Get the .zip file from the developer and unzip it on your computer.
2. Open the App: Navigate into the unzipped folder and open the index.html file directly in your web browser.

The application will now be running completely from your local machine.

Technologies

• React: A JavaScript library for building user interfaces.
• TypeScript: A typed superset of JavaScript that compiles to plain JavaScript.
• Vite: A fast and modern build tool for web development.
• pdf-lib: A JavaScript library for creating and modifying PDF documents.
• mammoth.js: A library for converting .docx files to HTML.
• html2pdf.js: A library to generate PDFs from HTML.
• Lovable UI: A stunning, modern UI framework.
• AI-Assisted Development: Coded with the help of Cascade, an agentic AI coding assistant.

Setup and Development

1. Clone the repository:

   git clone https://github.com/your-username/offline-pdf-utility.git
   cd offline-pdf-utility

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open the application: Open your browser and navigate to the local URL provided by Vite (usually http://localhost:5173).

Contribution Guidelines

We welcome contributions! If you have an idea for a new feature or have found a bug, please open an issue to discuss it. Pull requests are also welcome.

Contact

For any questions or feedback, please reach out via GitHub Issues.