Email Grouper

Practical, high-performance bulk email grouping, cleaning, and delimiter formatting utility.

100% In-Browser • Zero Server • Zero Data Retention • Offline Capable

Live App • Vib Tools Official • Report Bug • Request Feature

---

Overview

Email Grouper (formerly Ekta Grouper) is a dedicated client-side utility engineered by Vib Tools to solve the real-world friction of partitioning massive email contact lists into batch-ready formats for email service providers (ESPs), BCC blasts, cold campaigns, and CRM workflows.

Whether you need to group 50,000 emails into batches of 50 separated by commas, semicolons, newlines, or custom pipe symbols, Email Grouper processes your data entirely within your browser in milliseconds without a single byte leaving your computer.

---

Key Features

• 🔒 Zero Server Transmission (100% Client-Side): All text parsing, filtering, and splitting runs directly on your local device via JavaScript engines. No API keys, tracking, or remote databases.
• ⚡ High-Performance Chunking: Tested with over 50,000+ email addresses with instant batch generation and zero UI freeze.
• 🧹 Data Sanitization & Cleaning Engine:
  • Deduplication: Automatically detect and strip out duplicate email entries with one click.
  • Syntax Validation: Purge malformed emails and invalid syntax using RFC-compliant validation algorithms.
  • Normalization: Trim whitespace and lowercase strings for consistent processing.
• 🔀 Flexible Separator Support:
  • Comma (, )
  • Semicolon (; )
  • Newline (\n)
  • Space ( )
  • Pipe (|)
  • Tab (\t)
  • Custom user-defined delimiters
• 📋 One-Click Batch Copy & CSV Export:
  • Copy individual batches with dedicated copy feedback.
  • Copy all generated batches simultaneously.
  • Export all batches to structured .csv files for direct spreadsheet or CRM import.
• 📱 Adaptive Cross-Device UI:
  • Compact, high-contrast light interface optimized for density and readability.
  • Dedicated desktop sidebar with batch grid view.
  • Native-feeling mobile layout with bottom navigation bar (Batches, Source, Clean, Group).
• 📴 Offline-Ready Progressive Web App (PWA): Installable and works completely offline without an internet connection.

---

Quick Start

Online Usage

Access the production application immediately at: 👉 https://grouper.vib.tools/

Local Development

Prerequisites

• Node.js 18+ or 20+
• npm 9+ or pnpm / yarn

Installation

# Clone the repository
git clone https://github.com/vibtools/tools-email-grouper.git
cd tools-email-grouper

# Install dependencies
npm install

# Start local development server
npm run dev

Visit http://localhost:3000 in your web browser.

Building for Production

# Compile and build production bundle
npm run build

# Preview production build locally
npm run preview

The compiled output will be generated inside the dist/ directory, ready for deployment to any static hosting service (Cloudflare Pages, Vercel, GitHub Pages, Netlify).

---

Deployment to Cloudflare Pages

Email Grouper is 100% client-side SPA and requires zero Cloudflare Workers or server-side functions.

Setting	Value
Build Command	npm run build
Build Output Directory	dist
Root Directory	/
Custom Domain	grouper.vib.tools

Includes pre-configured public/_redirects for SPA routing and public/_headers with high-security HTTP headers. See CLOUDFLARE_PAGES.md for full instructions.

---

Tech Stack

• Framework: React 18+ with TypeScript
• Bundler: Vite
• Styling: Tailwind CSS
• Icons: lucide-react
• PWA: vite-plugin-pwa with service worker caching
• Export: Client-side RFC 4180 CSV blob generation

---

About Vib Tools

Vib Tools builds practical desktop applications, self-hosted software, automation tooling, developer utilities, reusable frameworks, and open-source projects for real workflows.

“Build free and open-source tools that help people do real work with less complexity.”

Organization & Contacts

• Website: https://vib.tools/
• GitHub: @vibtools
• GitLab: @vibtools
• General Inquiries: hello@vib.tools
• Support & Security: support@vib.tools
• WhatsApp / Phone: +880 1795-470603 (GMT+6)
• Head Office: 5660 Kochakata, Nageswari, Kurigram, Rangpur, Bangladesh

Maintainer

• Md Nurnobi (@victorsteele) — Connected GitHub account administrator.

---

Open-Source Ecosystem by Vib Tools

Explore other practical open-source software from Vib Tools:

• Portable Account Browser: Portable multi-account Chromium browser with isolated profiles.
• ContextVault: Portable ChatGPT conversation archive and RAG-ready exporter.
• MailStack: Self-hosted business mail server and shared team inbox.
• Licora: Central license management system.
• Vib Project Template: Technology-neutral repository foundation.

---

Contributing

Contributions, bug reports, and feature suggestions are welcome! Please read our CONTRIBUTING.md and CODE_OF_CONDUCT.md before submitting pull requests.

---

Security

Security and privacy are core engineering values at Vib Tools. For responsible vulnerability disclosure, please refer to SECURITY.md or email support@vib.tools.

---

License

This project is open-source software licensed under the MIT License.
Copyright © 2026 Vib Tools and Md Nurnobi.