What is Email Provider Links?
Email Provider Links is a completely free and open source JavaScript/TypeScript library that automatically detects email providers and retrieves their login URLs. It helps create seamless user experiences by guiding users directly to their email inbox after registration or email verification. 100% Free Forever:
How does it work?
1. Domain Matching
Instantly recognizes popular providers like Gmail, Outlook, Yahoo, and 40+ others from a curated database.
2. DNS Lookup
For unknown domains, performs MX record analysis to identify the underlying email infrastructure.
3. Heuristic Analysis
Uses advanced patterns to detect email alias services and proxy providers.
4. Fallback Handling
Gracefully handles unknown providers while still providing useful feedback.
Why Use Email Provider Links?
❌ The Problem
- Users abandon registration flows when they can't find verification emails
- Generic "check your email" messages provide no helpful guidance
- Users don't know which email app to open or where to look
✅ The Solution
- Automatically detect the user's email provider
- Show provider-specific instructions and branding
- Provide direct "Go to Gmail" or "Check Outlook" buttons
- Reduce user confusion and improve completion rates
Benefits
Perfect For
🚀 User Registration
Guide new users directly to their inbox after they sign up, improving email verification completion rates.
🔐 Password Reset
Help users quickly find and access password reset emails by showing them exactly where to look.
📧 Email Verification
Reduce bounce rates in verification flows by providing clear, provider-specific guidance.
💼 Business Applications
Detect corporate email systems and provide appropriate messaging for business users.
Enterprise-Grade Security
All provider URLs must use HTTPS protocol
Only pre-approved domains are allowed (93+ verified providers)
Blocks IP addresses, URL shorteners, suspicious TLDs
Detects and blocks ../ and encoded variants
Prevents javascript:, data:, and script injections
SHA-256 hash verification for provider database
Get Started
📦 Installation
Install using npm:
npm install @mikkelscheike/email-provider-links🛠️ Basic Usage
import { detectEmailProvider } from '@mikkelscheike/email-provider-links';
const result = await getEmailProvider('user@gmail.com');
console.log(result);
// {
// provider: {
// companyProvider: 'Gmail',
// loginUrl: 'https://mail.google.com/mail/'
// },
// email: 'user@gmail.com',
// loginUrl: 'https://mail.google.com/mail/',
// detectionMethod: 'domain_match'
// }Built With Amazing Tools
⚡ Warp Terminal
Warp is the modern, AI-powered terminal that made this development process incredibly fast and efficient. With its intelligent command completion, AI assistance, and modern interface, Warp transformed how I interacted with the codebase.
🐙 GitKraken
GitKraken provided powerful Git visualization and management capabilities that streamlined our version control workflow. Its intuitive interface and advanced merge tools made managing the codebase seamless and efficient.