email-validation-system
v1.0.0
Published
Comprehensive email validation library with format checking, disposable email detection, domain typo detection, MX record verification, and bulk CSV/Excel processing
Downloads
117
Maintainers
Readme
Email Project
A Next.js application built with TypeScript and Tailwind CSS for validating email addresses.
Features
1. Single Email Validation
- Format Validation: Checks email structure, length, and character rules
- Disposable Email Detection: Identifies temporary/throwaway email services
- Domain Typo Detection: Catches common misspellings (gmai.com, yahooo.com, etc)
- Suspicious Pattern Detection: Detects unusual patterns like repeated characters
- MX Domain Verification: Confirms the domain has valid Mail Exchange records
- Company/Domain Display: Shows the company name extracted from the email domain
- Detailed Results: Shows which validation checks passed/failed
2. Bulk Email Validation (CSV/XLSX Upload)
- Upload CSV or XLSX (Excel) files with email addresses
- Line-by-line validation with comprehensive checks
- Results table showing: Company | Email | Format ✓ | Disposable ✓ | Typo ✓ | MX ✓ | Overall Status
- Export detailed results as CSV (includes company and domain info)
- Supports standard CSV/XLSX format with an "email" column
Company/Domain Name Extraction
The validator automatically extracts and displays the company name from the email domain:
- Works for all emails - helpful for understanding which organization the email belongs to
- Displayed in both single email validation and bulk validation results
- Included in CSV export for record keeping
- Format Check - Validates email structure and character rules
- Disposable Email Check - Detects temporary email services
- Domain Typo Detection - Catches common domain misspellings
- MX Domain Check - Verifies domain has valid Mail Exchange records
- Suspicious Pattern Detection - Identifies suspicious email patterns
Disposable Email Domains Detected
- tempmail.com, 10minutemail.com, guerrillamail.com, mailinator.com, and more
Common Domain Typos Detected
- Gmail: gmial.com, gmai.com, gmali.com
- Yahoo: yahooo.com, yaho.com
- Outlook: outlok.com, outloo.com
- Hotmail: hotmai.com, hotmial.com
Getting Started
Run the development server:
npm run devOpen http://localhost:3000 to view the application.
How to Use
Single Email Validation
- Go to the "Single Email" tab
- Enter an email address
- Click "Validate Email"
- See format and MX domain validation results
Bulk Email Validation
- Go to the "Bulk Upload (CSV/XLSX)" tab
- Upload a CSV or XLSX file with an "email" column
- Click "Upload" or drag the file
- Results display in a table with each email's validation status
- Download results as CSV for record keeping
CSV/XLSX Format Example
email
[email protected]
[email protected]
[email protected]For XLSX files, ensure there's an "email" column header with email addresses below it.
Available Scripts
npm run dev- Start development servernpm run build- Build for productionnpm start- Run production servernpm run lint- Run ESLint
API Endpoints
POST /api/validate-email- Validate a single emailPOST /api/validate-bulk-emails- Validate emails from CSV file
Project Structure
src/app/- App Router pagessrc/components/- React componentssrc/lib/- Utilities (email validator, CSV parser)src/app/api/- API routes
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
Learn More
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Check out our Next.js deployment documentation for more details.
