https://github.com/sabarinathrajendran/pdf-cropper
✂️ A fast, beautiful, and privacy-friendly PDF cropper built with React, Vite, and Tailwind — crop pages your way, all in the browser.
https://github.com/sabarinathrajendran/pdf-cropper
ai client-side crop-pdf document-tools opensource pdf pdf-crop pdf-cropper pdf-editor pdfjs react tailwindcss vite
Last synced: 12 months ago
JSON representation
✂️ A fast, beautiful, and privacy-friendly PDF cropper built with React, Vite, and Tailwind — crop pages your way, all in the browser.
- Host: GitHub
- URL: https://github.com/sabarinathrajendran/pdf-cropper
- Owner: SabarinathRajendran
- Created: 2025-06-27T20:01:45.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-27T20:32:58.000Z (12 months ago)
- Last Synced: 2025-06-27T21:28:10.449Z (12 months ago)
- Topics: ai, client-side, crop-pdf, document-tools, opensource, pdf, pdf-crop, pdf-cropper, pdf-editor, pdfjs, react, tailwindcss, vite
- Language: JavaScript
- Homepage: https://sabarinathrajendran.github.io/pdf-cropper/
- Size: 121 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PDF Cropper ✂️📄 (Built with Just AI)
Welcome to **PDF Cropper**, your new best friend for slicing and dicing PDFs without breaking a sweat! Built with **Vite**, **Tailwind CSS**, and some snazzy **Lucide React** icons, this React app lets you crop PDF pages like a pro — or at least like someone who really loves neat corners.
---
## Features That’ll Make You Smile 😄
- Drag, drop, and upload your PDFs faster than you can say “Where’s my crop tool?”
- Crop one page, some pages, or the whole darn book — you’re the boss!
- Powered by **Vite** for lightning-fast starts, so no waiting around sipping coffee ☕
- Styled with **Tailwind CSS** because looking good is half the job done
- All done client-side — your PDFs stay private (and secret!) on your device
---
## See It In Action
*No demo yet? Well, hold tight. We’re cooking something tasty!*
---
## Getting Started (Because Everyone Loves a Good Tutorial) 🚀
### What You’ll Need
- Node.js (latest is greatest - built with v22.17.0)
- npm or yarn — your pick of the package manager flavor
### How To Get This Party Started
1. Clone it like it’s hot:
```
git clone https://github.com/SabarinathRajendran/pdf-cropper.git
cd pdf-cropper
```
2. Install all the goodies:
```
npm install
# or
yarn install
```
3. Fire it up:
```
npm run dev
# or
yarn dev
```
4. Open your browser and head to [http://localhost:5173](http://localhost:5173) — the magic happens here.
---
## How To Use (No Rocket Science Here)
1. Upload your PDF like a boss.
2. Check out your pages with smooth scrolling and sweet transitions.
3. Use the crop handles to define the area to keep.
4. Choose to apply the crop to a single page, specific pages (comma separated), or all pages.
5. Export and download your cropped PDF with pride.
---
## What’s Under The Hood? 🐎
- PDF wizardry courtesy of [pdf.js](https://mozilla.github.io/pdf.js/) — it’s like magic, but real.
- React + SVG overlays keep your cropping crisp and clean.
- Crop once, apply everywhere — because who likes doing the same thing twice?
- All on your machine, no mysterious servers involved. Your secrets are safe with us.
---
## Tech Stack — The Secret Sauce 🌶️
- [Vite](https://vitejs.dev/) — blazingly fast dev tool (seriously, blink and it’s ready)
- [React](https://reactjs.org/) — the UI hero
- [Tailwind CSS](https://tailwindcss.com/) — stylish without the drama
- [Lucide React](https://lucide.dev/docs/react/) — shiny icons to click on
- [pdf.js](https://mozilla.github.io/pdf.js/) — PDF whisperer
---
## Wanna Contribute? We ❤️ That!
Got ideas? Found a bug? Wanna add a funky new feature? Here’s how:
1. Fork the repo and make it yours
2. Create a branch with a cool name
```
git checkout -b feature/amazing-new-thing
```
3. Commit your awesomeness
```
git commit -m "Add amazing new thing"
```
4. Push it
```
git push origin feature/amazing-new-thing
```
5. Open a Pull Request and bask in the glory of community contribution
Remember, nice code and tests get extra cookies 🍪
---
## License (Because Sharing is Caring)
This little gem is licensed under the **MIT License** — so go nuts, just don’t sue us!
---
## Talk To Me! 📬
Questions, jokes, or just wanna say hi? Open an issue or ping me on GitHub.
I don’t bite (much).
---
Thanks for checking out **PDF Cropper** — now go forth and crop like a champ! ✂️😎