LeadSlicer
Upload any lead file (CSV or Excel), clean it, filter it, and split it into smaller chunks — all from your browser. No signup. No upload to any server. Your data stays on YOUR machine.
- Language
- JavaScript
- Stars
- 0
- Last updated
- License
- MIT
From the README
Free, offline, browser-based tool to upload, filter, deduplicate, and split CSV/XLSX lead files into smaller chunks.
🔒 Your files never leave your device. Everything runs 100% in the browser.
🖥️ Screenshots
| Light Mode | Dark Mode |
|---|---|
🎯 What It Does
LeadSlicer takes your large lead file and lets you:
- Upload — Drag & drop any
.csvor.xlsxfile - Preview — See the first few rows, total row & column counts
- Configure headers — Use first row as header or auto-generate column names
- Select columns — Keep only the columns you need
- Filter & clean — Remove duplicates, empty rows, and rows with missing values
- Chunk — Split into smaller files of any size (100, 500, 1000+ rows)
- Download — Get individual files or everything as a ZIP
⚡ Features
| Feature | Description |
|---|---|
| 📂 CSV & XLSX support | Upload .csv, .xlsx, and .xls files |
| 📅 Format preserved | Dates, currency and number formats come out exactly as they went in |
| 🔍 File preview | See data before processing |
| 🧹 Duplicate removal | Remove duplicates based on any column (Email, Phone, etc.) |
| 🗑️ Empty row cleanup | Automatically strip blank rows |
| 📊 Column selection | Keep only the fields you need |
| ✂️ Custom chunk sizes | Split into any number of rows per file |
| 📦 ZIP download | Download all chunks in one click |
| 👁️ Chunk preview | Preview each chunk before downloading |
| 🎨 Theme system | Light / Dark / System appearance + 6 accent colours |
| 📱 PWA / Installable | Install on Android, iOS, or Desktop |
| ✈️ Works offline | Once loaded, no internet required |
| 🔒 100% private | Files never leave your browser |
| ♿ Accessible | Keyboard navigable, semantic HTML |
| 📐 Responsive | Works on mobile, tablet, and desktop |
🚀 Quick Start
Option 1: Use Online
Visit leadslicer.abdulmanan.tech — no install needed.
Option 2: Run Locally
# Clone the repo git clone https://github.com/abdulmanan69/leadslicer.git # Open it cd leadslicer # Just open index.html in your browser — that's it! start index.html # Windows open index.html # macOS xdg-open index.html # Linux
No build step. No dependencies to install. No server needed.
📂 Project Structure
leadslicer/
├── index.html # Main application
├── offline.html # Offline fallback page
├── manifest.json # PWA manifest
├── sw.js # Service Worker
├── robots.txt # SEO crawl rules
├── sitemap.xml # XML sitemap
├── favicon.ico # Favicon
├── _headers # Security headers (Cloudflare Pages)
├── netlify.toml # Netlify config
├── css/
│ └── styles.css # All styles (light + dark theme)
├── js/
│ ├── app.js # Main app controller (wizard UI)
│ ├── themeManager.js # Appearance modes + accent palettes
│ ├── fileProcessor.js # File parsing, validation, filtering
│ └── chunkExporter.js # Chunk creation & download (CSV/XLSX/ZIP)
├── lib/
│ ├── xlsx.full.min.js # SheetJS — Excel parsing
│ ├── papaparse.min.js # PapaParse — CSV parsing
│ ├── jszip.min.js # JSZip — ZIP creation
│ └── FileSaver.min.js # FileSaver — Download triggers
└── icons/ # PWA icons (16px – 512px) + OG image
🧠 How the Processing Works
Upload File
│
▼
Validate Format (.csv / .xlsx)
│
▼
Detect Headers (auto or first row)
│
▼
Select Columns to Keep
│
▼
Apply Filters
├── Remove empty rows
├── Remove duplicates (by selected columns)
└── Remove rows with missing required values
│
▼
Configure Chunk Size
│
▼
Generate Chunk Files
│
▼
Download (Individual or ZIP)
📅 Format Fidelity
A value comes out of LeadSlicer looking exactly like it went in. Spreadsheets
store a date as a serial number (05/03/2026 is really 46086) and only show
it as dd/mm/yyyy because of the cell's number format — so a naive reader hands
you the raw serial and your dates turn into meaningless integers.
LeadSlicer avoids that on both ends:
- On import, the workbook is read with
cellDates,cellNFandcellText, and every cell is taken as its rendered text. Add/mm/yyyycell reads back as05/03/2026, never46086. Each column's number format is recorded. - On export, that format is reapplied. The date is written as a real date
cell carrying
dd/mm/yyyy, so Excel shows and sorts it exactly as before. Anything that cannot be parsed back with confidence stays as literal text rather than being guessed at. - CSV is passed through byte-for-byte — no re-interpretation, no locale surprises, UTF-8 BOM preserved so Excel opens it correctly.
The same applies to currency and number formats: 1,234.50 stays 1,234.50.
| Signup Date | Amount | |
|---|---|---|
| Source file | 05/03/2026 |
1,234.50 |
| Exported chunk | 05/03/2026 |
1,234.50 |
🎨 Theming
Click the button in the top-right corner to open the theme picker:
- Appearance — Light, Dark, or System (follows your OS and updates live)
- Accent — Indigo, Violet, Emerald, Rose, Amber, or Cyan
Preferences persist in localStorage, sync across open tabs, and are applied
before first paint so there is no flash of the wrong theme on load.
Shift-click the button to cycle appearance without opening the panel.
💡 Use Cases
| Who | How They Use It |
|---|---|
| Sales Teams | Split lead lists for different reps or territories |
| Email Marketers | Break large lists into campaign-sized batches |
| Lead Gen Agencies | Clean and chunk client data before delivery |
| Virtual Assistants | Process and organize data faster |
| Recruiters | Split candidate lists into manageable segments |
| Anyone | Who works with large spreadsheets |
📱 PWA
LeadSlicer is a fully installable Progressive Web App:
- ✅ Works offline after first load
- ✅ Install on Android, iOS, and Desktop
- ✅ Cached with Service Worker
- ✅ Splash screen & standalone mode
Install: Visit the site → click "Install" in browser address bar (or "Add to Home Screen" on mobile).
🔒 Privacy & Security
- Zero data collection — No analytics, no tracking, no cookies (unless you add GA)
- No server uploads — All processing happens in your browser via JavaScript
- No external API calls — Fully self-contained
- Security headers — CSP, HSTS, X-Frame-Options, X-Content-Type-Options
- HTTPS enforced — via Cloudflare
Your data stays on your machine. Period.
⚙️ Tech Stack
| Technology | Purpose |
|---|---|
| HTML5 / CSS3 / ES6+ | Core app |
| SheetJS | Excel file parsing & generation |
| PapaParse | CSV parsing |
| JSZip | ZIP file creation |
| FileSaver.js | Client-side file downloads |
| Service Worker | Offline support & caching |
| CSS Custom Properties | Light/dark theme system |
No frameworks. No build tools. No Node.js. Pure vanilla.
🧪 Lighthouse Scores
| Category | Score |
|---|---|
| Performance | 95+ |
| Accessibility | 95+ |
| Best Practices | 95+ |
| SEO | 100 |
| PWA | ✅ |
🤝 Contributing
Contributions are welcome! Here's how:
- Fork the repo
- Create a feature branch:
git checkout -b feature/my-feature - Commit your changes:
git commit -m "Add my feature" - Push:
git push origin feature/my-feature - Open a Pull Request
Ideas for contributions:
- Save/load filter configuration templates
- Support for more file formats (TSV, JSON)
- Column data type detection
- Data visualization / charts
- Multi-language support (i18n)
- Custom naming patterns for output files
📄 License
This project is licensed under the MIT License — see the LICENSE file for details.
MIT License
Copyright (c) 2026 Abdul Manan
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
🔗 Links
- Live App: leadslicer.abdulmanan.tech
- Portfolio: abdulmanan.tech
- LinkedIn: Connect with me
Built with ❤️ by Abdul Manan
If this tool saved you time, give it a ⭐ on GitHub!