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.

Live Demo License PWA


🖥️ Screenshots

Light Mode Dark Mode
Light Mode Dark Mode

🎯 What It Does

LeadSlicer takes your large lead file and lets you:

  1. Upload — Drag & drop any .csv or .xlsx file
  2. Preview — See the first few rows, total row & column counts
  3. Configure headers — Use first row as header or auto-generate column names
  4. Select columns — Keep only the columns you need
  5. Filter & clean — Remove duplicates, empty rows, and rows with missing values
  6. Chunk — Split into smaller files of any size (100, 500, 1000+ rows)
  7. 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, cellNF and cellText, and every cell is taken as its rendered text. A dd/mm/yyyy cell reads back as 05/03/2026, never 46086. 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:

  1. Fork the repo
  2. Create a feature branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -m "Add my feature"
  4. Push: git push origin feature/my-feature
  5. 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


Built with ❤️ by Abdul Manan
If this tool saved you time, give it a ⭐ on GitHub!