PDFCraftTool/pdfcraft

Professional PDF Tools

Free, Private & Browser-Based

Merge, split, compress, convert, and edit PDF files online without uploading to servers.

PDFCraft is a comprehensive suite of PDF tools designed for privacy and performance. Unlike many online converters, PDFCraft processes your files entirely within your browser using WebAssembly technology. Your documents never leave your device, ensuring maximum security for your sensitive data.

This project is built with modern web technologies to provide a slick, app-like experience directly in the browser.

• 🔒 100% Private: All processing happens client-side. No file uploads to external servers.
• 🚀 Fast & Responsive: Powered by Next.js and WebAssembly for near-native performance.
• 🛠️ Comprehensive Toolset: Over 80+ tools to handle any PDF task.
• 🎨 Modern UI: Clean, accessible, and responsive design built with Tailwind CSS.
• 🌐 Multi-language: Supports English, Spanish, French, German, Portuguese, Japanese, Korean, and Chinese.

⚠️ Early Development Notice: This feature is currently in early development stage. You may encounter bugs or incomplete functionality. We appreciate your feedback and patience!

PDFCraft includes a powerful visual workflow editor that allows you to chain multiple PDF operations together, creating automated processing pipelines.

Visual workflow editor with drag-and-drop interface

• 🔗 Visual Node-Based Editor: Drag and drop tools onto a canvas and connect them to create processing pipelines
• 📋 23+ Pre-built Templates: Common workflows like "Merge & Compress", "Secure PDF", "Document Preparation", etc.
• 💾 Save & Reuse: Save your custom workflows for future use
• 🎯 Real-time Validation: Automatic format compatibility checking between connected tools
• 📁 Batch Processing: Process multiple files through the same workflow
• ↔️ Collapsible Panels: Maximize canvas workspace with collapsible tool and library sidebars

Navigate to /workflow or click on "Workflow Editor" in the navigation menu.

• Framework: Next.js 15 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4
• PDF Processing:
  • PDF.js
  • pdf-lib
  • PyMuPDF (WASM)
• State Management: Zustand

To run this project locally, follow these steps:

• Node.js 18.17 or later
• npm, yarn, or pnpm

1. Clone the repository

   git clone https://github.com/PDFCraftTool/pdfcraft.git
   cd pdfcraft

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Start the development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev

4. Open your browser Navigate to http://localhost:3000 to see the application running.

PDFCraft provides both pre-built Docker images and Docker Compose for flexible deployment options.

The easiest way to run PDFCraft is using our pre-built image from GitHub Container Registry:

# Pull the latest image
docker pull ghcr.io/pdfcrafttool/pdfcraft:latest

# Run the container
docker run -d -p 8080:80 --name pdfcraft ghcr.io/pdfcrafttool/pdfcraft:latest

Open http://localhost:8080 to access PDFCraft.

Available tags:

If you want to build from source or need to modify the code:

⚠️ Note: This method requires cloning the repository first.

# Clone the repository
git clone https://github.com/PDFCraftTool/pdfcraft.git
cd pdfcraft

# Development mode (with hot reload)
docker compose --profile dev up

# Production mode (static build + Nginx)
docker compose --profile prod up --build

• Development: http://localhost:3000
• Production: http://localhost:8080

To stop containers:

docker compose down

PDFCraft supports deployment under a subpath (e.g., https://your-domain.com/pdfcraft/). To enable this, you must specify the base path during the build process.

Using Docker Build:

docker build --build-arg BASE_PATH=/pdfcraft -t pdfcraft .

Using Docker Compose:

services:
  pdfcraft:
    build:
      context: .
      args:
        - BASE_PATH=/pdfcraft
    environment:
      - BASE_PATH=/pdfcraft

Note: Since the app is statically exported, the BASE_PATH must be provided during the build stage.

• npm run dev: Starts the development server with Turbopack. Automatically runs predev to decompress LibreOffice WASM files.
• npm run build: Builds the application for production. Automatically runs postbuild to decompress WASM files in out/.
• npm run start: Starts the production server.
• npm run lint: Lints the code using ESLint.
• npm run test: Runs tests using Vitest.

PDFCraft is configured for static export (output: 'export'), which means it can be deployed to any service that supports static website hosting without requiring a Node.js server.

📖 For comprehensive deployment instructions, see DEPLOYMENT.md

1. Build the project:

   npm run build

   All static files will be generated in the out directory.

2. Deploy to your preferred platform:

   • Vercel (Recommended): vercel --prod
   • Netlify: netlify deploy --prod --dir=out
   • GitHub Pages: Push to main branch (uses GitHub Actions)
   • Cloudflare Pages: wrangler pages deploy out
   • Docker + Nginx: docker compose --profile prod up --build

• Headers Configuration: Security and caching headers are pre-configured in all deployment files.
• Image Optimization: Static export uses images: { unoptimized: true }.
• WASM Support: All deployment configs include proper MIME types for WebAssembly.
• Subpath Support: Set BASE_PATH environment variable during build to deploy under a subdirectory.

After deployment, please check the following features to ensure everything is working correctly:

• Multi-language routing (e.g., /en, /zh)
• Tool page loading
• WebAssembly (PDF processing) functionality

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

PDFCraft stands on the shoulders of giants. We gratefully acknowledge BentoPDF for their pioneering work in privacy-first, client-side PDF tools.

Their project served as a significant inspiration and reference for our core logic. While PDFCraft has been re-engineered for the Next.js ecosystem and extends functionality with unique features like the Workflow Editor, we deeply respect the foundation laid by the BentoPDF team.

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.