A modern web application for merging multiple PDF pages onto single sheets, built for students and professionals who want to optimize their printing.
|
|
Core Features
- 📄 Smart PDF Combining - Merge 2, 3, 4, or 6 pages per sheet
- 🎨 Visual Customization - Apply grayscale, color inversion, and background options
- 🎯 Quality Control - Adjustable DPI settings (150-300 DPI) for perfect print quality
- 🔄 Drag & Drop Interface - Intuitive file management with reordering capabilities
- ⚙️ Real-time Processing - Instant preview and processing feedback
Privacy & Security
- 🛡️ Privacy First - All processing happens locally in your browser
- 🚫 No Uploads - Your files never leave your device
- ✅ Secure - No server-side storage or data collection
- 🌐 Offline Ready - Works without internet connection when installed
Progressive Web App
- 📱 Install on Any Device - Works on desktop, mobile, and tablet
- 🎭 App-like Experience - Native feel with smooth animations
- 🔄 Background Processing - Continue processing when switching tabs
- 🔔 Smart Notifications - Get notified when processing completes
- 📴 Offline Support - Use the app without internet connection
Clean, modern interface for uploading PDF files |
Intuitive controls for configuring PDF settings |
Responsive design optimized for mobile devices and touch interactions
Prerequisites
- Node.js 18+ or Bun runtime
- Modern web browser with PDF support (Chrome, Firefox, Safari, Edge)
# Clone the repository
git clone https://github.com/mosaddiqdev/onepdf.git
cd onepdf
# Install dependencies
bun install
# or npm install
# Set up environment variables
cp .env.example .env.local
# Start development server
bun run dev
# or npm run dev
# Open your browser
# http://localhost:3000Configuration Options
Environment variables can be configured in .env.local:
# File size limits (in MB)
NEXT_PUBLIC_MAX_FILE_SIZE=50
NEXT_PUBLIC_MAX_TOTAL_SIZE=200
# Processing limits
NEXT_PUBLIC_MAX_FILES=20
NEXT_PUBLIC_MAX_PAGES_PER_FILE=500
# Timeout settings (in milliseconds)
NEXT_PUBLIC_PROCESSING_TIMEOUT=1800000
NEXT_PUBLIC_FILE_LOAD_TIMEOUT=60000| 💻 Look for the install icon in your browser's address bar | 📱 Use "Add to Home Screen" from your browser menu | 🖥️ The app will prompt you to install after 30 seconds |
| Category | Technology | Purpose |
|---|---|---|
| Framework | Next.js 16 | React framework with App Router |
| Language | TypeScript | Type-safe JavaScript |
| Styling | Tailwind CSS 4 | Utility-first CSS framework |
| PDF Processing | PDF-lib | PDF manipulation library |
| PDF Rendering | PDF.js | Mozilla's PDF rendering engine |
| Animations | Framer Motion | Smooth animations and transitions |
| File Upload | React Dropzone | Drag & drop file upload |
| Notifications | Sonner | Beautiful toast notifications |
Project Structure
onepdf/
├── app/ # Next.js App Router
│ ├── combine/ # PDF combining page
│ ├── layout.tsx # Root layout with PWA setup
│ └── page.tsx # Landing page
├── components/ # React components
│ ├── combine/ # Combine-specific components
│ ├── ui/ # Reusable UI components (shadcn/ui)
│ └── pwa/ # PWA components & install prompts
├── hooks/ # Custom React hooks
│ ├── use-processing.ts # PDF processing logic
│ ├── use-file-manager.ts # File management
│ └── use-background-notifications.ts # PWA notifications
├── lib/ # Utility functions & core logic
│ ├── pdf-processor.ts # Main PDF processing engine
│ ├── pdf-render.worker.ts # Web Worker for background processing
│ ├── validation.ts # Input validation & sanitization
│ └── utils.ts # General utilities
└── public/ # Static assets
├── icons/ # PWA icons & favicons
├── images/ # Screenshots & showcase images
└── pdfjs/ # PDF.js worker & WASM files
Vercel (Recommended)
- Push your code to GitHub
- Connect your repository to Vercel
- Deploy automatically on every push
Other Deployment Options
- Netlify - Connect GitHub repo for automatic deployments
- Docker - Use the included Dockerfile for containerized deployment
- Self-hosted - Deploy on any Node.js hosting provider
See DEPLOYMENT.md for detailed instructions.
We welcome contributions from the community!
| 🐛 Found an issue? Let us know! | 💡 Have an idea? We'd love to hear it! | 🤝 Want to contribute code? Awesome! |
How to Contribute
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Raghav Sharma - Reported critical background processing bug that led to implementing Web Worker architecture for uninterrupted PDF processing.
- Almas - Identified JPEG 2000 rendering issues with black/corrupted images, leading to implementation of proper WASM support for OpenJPEG decoding in PDF.js.