Skip to content
indreshharshanPublic

About

A full-stack MERN app for sending bulk email campaigns via SendGrid, with Excel recipient uploads and a Groq-powered AI writing assistant.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

Screenshot 2026-08-25 084359

Modern Full-Stack Bulk Email Management Platform

Typing SVG

Live Demo GitHub Stars License


React Node.js Express MongoDB Tailwind JWT SendGrid Vercel


✨ About

BulkMail is a full-stack web application for managing and sending bulk emails through a simple, modern, and animated interface. Users can upload recipient files, compose emails, preview messages, send campaigns using SendGrid, and track their email history — all wrapped in a fast, secure MERN-stack app.


🚀 Features

🔐 Auth & Security

  • Secure login & signup with JWT
  • Password hashing via bcrypt.js
  • Fully protected API routes

📂 Recipient Management

  • Excel (.xlsx) file upload
  • Automatic validation & counting
  • Duplicate/invalid email filtering

📧 Campaigns

  • Bulk sending via SendGrid
  • Live email preview before send
  • Full campaign history log

🤖 AI & UX

  • Groq-powered AI email assistant
  • Responsive, animated UI
  • Smooth page transitions

🛠️ Tech Stack

Layer Technologies
Frontend React.js · Tailwind CSS · Axios
Backend Node.js · Express.js · JWT · bcrypt.js · Multer · XLSX
Database MongoDB + Mongoose
APIs SendGrid (email delivery) · Groq AI (assistant)
Deployment Vercel

🔄 Workflow

flowchart LR
    A[🔐 Login / Signup] --> B[📂 Upload Recipient File]
    B --> C[✅ Validate & Count Emails]
    C --> D[✍️ Compose Email]
    D --> E[👀 Live Preview]
    E --> F[📤 Send via SendGrid]
    F --> G[📜 Save Campaign History]

    style A fill:#6366F1,color:#fff
    style B fill:#8B5CF6,color:#fff
    style C fill:#A855F7,color:#fff
    style D fill:#EC4899,color:#fff
    style E fill:#F43F5E,color:#fff
    style F fill:#10B981,color:#fff
    style G fill:#06B6D4,color:#fff
Loading

⚙️ Getting Started

Prerequisites

  • Node.js v16+
  • MongoDB instance (local or Atlas)
  • SendGrid account with a verified sender
  • Groq API key

Installation

git clone https://github.com/indreshharshan/BulkMail.git
cd BulkMail
npm install

Run Locally

npm run dev

App runs at http://localhost:5000 🚀


📊 Project Status

Status Maintenance


👨‍💻 Developer

Indresh Harshan J.P Full-Stack Developer | AI & Prompt Engineering Enthusiast

GitHub LinkedIn

⭐ If you like this project, consider giving it a star!

About

A full-stack MERN app for sending bulk email campaigns via SendGrid, with Excel recipient uploads and a Groq-powered AI writing assistant.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages