Skip to content

IviweBooi/mergePDF

Repository files navigation

PDFMerge - Free PDF Merger for Students

A completely free, privacy-focused PDF merger created by a student, for students. No hidden fees, no watermarks, no registration required.

🌟 Features

  • 100% Free: No hidden fees, no premium features, no credit card required
  • Privacy First: All processing happens in your browser - files never leave your device
  • No Limitations: No file size limits, no watermarks, no restrictions
  • Student Made: Built by someone who understands student needs
  • Simple & Fast: Clean interface that gets the job done quickly
  • Drag & Drop: Intuitive file upload with drag and drop support
  • File Reordering: Drag files to reorder them before merging
  • Real-time Validation: Comprehensive form validation with instant feedback
  • Email Integration: Contact form with EmailJS integration for real email sending
  • Mobile Optimized: Perfect experience on all devices and screen sizes
  • Progress Tracking: Visual progress bar during PDF merging
  • File Management: Easy file removal and list management

πŸš€ How It Works

  1. Upload Files: Drag and drop your PDF files or click to browse
  2. Arrange & Preview: See all your files listed with their names and sizes
  3. Merge Locally: All processing happens in your browser using PDF-lib
  4. Download Result: Get your merged PDF instantly with a single click

πŸ› οΈ Technical Details

  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • PDF Processing: PDF-lib library for client-side PDF manipulation
  • Email Integration: EmailJS for contact form functionality
  • Form Validation: Custom validation system with real-time feedback
  • Styling: Custom CSS with modern design principles and animations
  • Responsive: Mobile-first design that works on all devices
  • Privacy: Zero server-side processing - everything happens locally
  • Drag & Drop: Native HTML5 drag and drop API
  • File Handling: Advanced file management with size formatting

πŸ“ Project Structure

mergePDF/
β”œβ”€β”€ index.html              # Home page with PDF merger
β”œβ”€β”€ about.html              # About page with story and mission
β”œβ”€β”€ how-it-works.html       # Technical details and process explanation
β”œβ”€β”€ privacy.html            # Privacy policy and data handling
β”œβ”€β”€ contact.html            # Contact form and FAQ
β”œβ”€β”€ styles.css              # Main stylesheet with responsive design
β”œβ”€β”€ script.js               # JavaScript functionality and form validation
β”œβ”€β”€ config.js               # EmailJS configuration
β”œβ”€β”€ EMAILJS_SETUP.md        # EmailJS setup guide
└── README.md               # This file

🎯 Pages Overview

Home Page (index.html)

  • Hero section with call-to-action
  • PDF upload and merging interface
  • Feature highlights
  • Story section
  • Privacy note

About Page (about.html)

  • The problem and solution
  • Creator introduction (Iviwe)
  • Mission and values
  • Call-to-action

How It Works (how-it-works.html)

  • Step-by-step process explanation
  • Technical details
  • Feature explanations
  • Browser compatibility

Privacy Page (privacy.html)

  • Privacy principles
  • Data handling explanation
  • Security measures
  • Third-party services

Contact Page (contact.html)

  • Contact information and methods
  • Interactive contact form with EmailJS integration
  • Real-time form validation with visual feedback
  • Character counter for message field
  • FAQ section with common questions
  • Feedback statistics and testimonials

πŸ”§ Setup and Installation

  1. Clone or Download: Get the project files
  2. Open in Browser: Simply open index.html in any modern web browser
  3. Start Using: No installation required - it's a static website!

EmailJS Setup (Optional)

To enable email functionality on the contact form:

  1. Follow the setup guide in EMAILJS_SETUP.md
  2. Update config.js with your EmailJS credentials
  3. Test the contact form

Requirements

  • Modern web browser (Chrome 60+, Firefox 55+, Safari 11+, Edge 79+)
  • JavaScript enabled
  • No server setup required
  • EmailJS account (optional, for contact form emails)

🎨 Design Features

  • Modern UI: Clean, professional design with smooth animations
  • Responsive: Works perfectly on desktop, tablet, and mobile
  • Accessible: Keyboard navigation and screen reader friendly
  • Fast: Optimised for performance with minimal dependencies
  • Cross-browser: Tested and working on all major browsers
  • Interactive Elements: Hover effects, transitions, and micro-interactions
  • Form Validation: Real-time validation with visual feedback
  • Loading States: Progress indicators and loading animations
  • Mobile Navigation: Hamburger menu for mobile devices

πŸ”’ Privacy & Security

  • Local Processing: All PDF operations happen in your browser
  • No Uploads: Files never leave your device
  • No Tracking: No analytics or tracking scripts
  • No Storage: No data is stored on any server
  • HTTPS Ready: Secure when hosted on HTTPS

🌐 Browser Compatibility

Browser Version Status
Chrome 60+ βœ… Full Support
Firefox 55+ βœ… Full Support
Safari 11+ βœ… Full Support
Edge 79+ βœ… Full Support

πŸ“± Mobile Support

  • Fully responsive design
  • Touch-friendly interface
  • Mobile-optimised navigation
  • Swipe gestures for file reordering

πŸš€ Performance

  • Lightning Fast: Client-side processing means no server delays
  • Memory Efficient: Optimized for large file handling
  • Progressive Loading: Smooth animations and transitions
  • Minimal Dependencies: Only PDF-lib for PDF processing
  • Form Validation: Instant feedback without page reloads
  • File Handling: Efficient drag and drop with visual feedback
  • Mobile Optimized: Touch-friendly interface with responsive design

🀝 Contributing

This is an open-source project created to help students. Contributions are welcome!

How to Contribute

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

Areas for Improvement

  • Additional file format support (Word, Excel, etc.)
  • Enhanced UI/UX features and animations
  • Performance optimisations for large files
  • Accessibility improvements and ARIA labels
  • Mobile app version (PWA)
  • Advanced PDF features (compression, password protection)
  • Batch processing capabilities
  • Cloud storage integration

πŸ“„ License

This project is open source and available under the MIT License.

πŸ‘¨β€πŸ’» Creator

Iviwe Booi - A student who believes in free tools for education

Created this tool because I struggled to find free PDF merging tools online. Almost all of them required payment or had hidden fees. That's why I created PDFMerge - a completely free tool that students can use without worrying about costs.

πŸ™ Acknowledgments

  • PDF-lib: The amazing JavaScript library that makes PDF processing possible
  • EmailJS: For providing seamless email integration
  • Inter Tight Font: Beautiful typography from Google Fonts
  • Student Community: For the inspiration and feedback
  • Open Source Community: For the tools and libraries that make this possible

πŸ“ž Contact

  • Email: booiiviwe4394@gmail.com
  • GitHub: github.com/IviweBooi/mergePDF
  • Issues: github.com/IviweBooi/mergePDF/issues

🎯 Mission

PDFMerge exists to provide students with free, reliable tools that support their educational journey. We believe that:

  • Education Should Be Free: Students shouldn't have to pay for basic tools
  • Privacy Matters: Your documents are personal and should remain private
  • Simplicity Works: Tools should be easy to use and get the job done

Made with ❀️ for students, by a student

"Education is the most powerful weapon which you can use to change the world." - Nelson Mandela

About

A completely free, privacy-focused PDF merger created by a student, for students. No hidden fees, no watermarks, no registration required.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors