⚡ SumanVolt PrintFlow

Zero-Friction, 100% Private Mobile Duplex Printing Engine

An offline-first Progressive Web App (PWA) designed to eliminate the frustration of manual double-sided printing, broken mobile margins, and complex print settings on Android and iOS devices.

---

🎯 The Problem It Solves

• Missing Mobile Duplex Options: Android and iOS print spoolers lack a simple "Print Odd Pages First, then Even Pages" manual sequence.
• Collation Confusion: Flipping sheets manually often leads to inverted or reverse-ordered pages ($1, 4, 3, 2\dots$).
• Privacy Risks: Many free web tools upload sensitive personal, academic, or financial documents to remote cloud servers to perform basic page slicing.
• Overly Complex UIs: Standard mobile print dialogs are filled with confusing toggles for scaling, margins, and paper trays.

---

✨ Features

• 🔄 Guided 2-Pass Duplex Wizard: Automatically splits PDF documents into clean Odd ($1, 3, 5\dots$) and Even ($2, 4, 6\dots$) passes.
• 🔃 3D Paper-Flip Guide: Interactive visual card showing exactly when and how to turn the printed stack over.
• 📐 Auto-Reverse Even Pages: Pre-inverts the second pass ($6, 4, 2$) so the final stack lands face-up in natural reading order.
• 🛡️ 100% Private & Client-Side: Processes files in-memory using WebAssembly/JavaScript (pdf-lib). Zero bytes leave your device.
• ⚡ Lossless Vector Quality: Direct PDF stream manipulation—no blurry canvas rasterization or DPI loss.
• 📱 Full Offline PWA: Works completely without an active internet connection once loaded.

---

🚀 How It Works

[ Upload PDF ] │ ▼ [ Client-Side Vector Slicer (pdf-lib) ] │ ├──► Step 1 (Odds): Slices [1, 3, 5...] ──► Download & Print │ ├──► Interactive 3D Flip Guide ──────────► Reload stack in tray │ └──► Step 2 (Evens): Slices [6, 4, 2...] ──► Download & Print │ ▼ [ Perfectly Collated Pages ]

---

🛠️ Tech Stack

• Frontend: Single-file HTML5 + Modern JavaScript (ES6+)
• Styling: Tailwind CSS (via CDN) + Pure CSS 3D Keyframe Animations
• PDF Processing: pdf-lib (Client-side vector engine)
• PWA & Offline: Service Worker (sw.js) + Web App Manifest (manifest.json)
• Hosting: GitHub Pages (Zero-build deployment)

---

📁 Repository Structure

sumanvolt-printflow/ ├── index.html # App UI, 3D animations, and PDF slicing logic ├── manifest.json # PWA metadata for installation ├── sw.js # Service Worker for offline asset caching ├── icon.svg # SumanVolt vector app icon └── README.md # Project documentation

---

📲 Installation

1. Visit the hosted web application on mobile Chrome or Safari.
2. Tap the browser menu (⋮ or Share).
3. Select Add to Home screen (or Install App).
4. Open PrintFlow directly from your app drawer—even in Airplane Mode.

---

📄 License

Distributed under the MIT License. Free for everyone to use and modify.

---

_{Built with ⚡ by SUMANVOLT}