Skip to content

yashj808/IceMail

Repository files navigation

Cold Email Personalizer

A free, AI-powered web tool that generates 3 personalized cold email variations using Google Gemini 2.0 Flash. No login, no subscription, no cost.

🔗 Live Demo: [Deploy URL here] 📦 GitHub: [Repo URL here]


Features

  • 3 email tones — Professional, Conversational, Bold
  • 🎯 Goal-aware framing — Job Referral, Freelance, Mentorship, Coffee Chat
  • 💰 Conditional CTC/Rate fields — naturally woven into emails when provided
  • 🔍 Spam word detection — 60+ trigger words highlighted in real time
  • 📊 Subject line scoring — 5-criterion rubric (length, personalization, hooks, etc.)
  • ✏️ Inline editing — edit any generated email directly in the browser
  • 📋 One-click copy — copy subject or full email instantly
  • 🔄 Per-tone regeneration — re-generate just one tone without losing others
  • 🕐 Generation history — last 5 sessions saved to localStorage, click to restore
  • 📱 Fully responsive — works on mobile and desktop

Tech Stack

Layer Choice
Framework React 18 + Vite
Styling Tailwind CSS v3
AI API Google Gemini 2.0 Flash (free)
State React useState / useCallback
Persistence localStorage
Fonts Inter (Google Fonts)
Deployment Vercel Hobby (free)

Total cost: ₹0 / $0


Setup

1. Clone and install

git clone https://github.com/your-username/cold-email-personalizer
cd cold-email-personalizer
npm install

2. Get a free Gemini API key

  1. Go to aistudio.google.com
  2. Sign in with any Google account
  3. Click Get API KeyCreate API Key
  4. Copy the key (starts with AIza...)

3. Configure environment

Create .env.local in the project root:

VITE_GEMINI_API_KEY=AIza...your_key_here

⚠️ Never commit .env.local — it's already in .gitignore

4. Run locally

npm run dev

Open http://localhost:5173


Deployment on Vercel

  1. Push your code to a public GitHub repository
  2. Go to vercel.com → Import project
  3. Add environment variable: VITE_GEMINI_API_KEY = your API key
  4. Deploy — it's free on the Hobby plan

Security Note

⚠️ Client-side API key: This is a portfolio/demo build. The Gemini API key is included in the frontend bundle. This is acceptable for a free-tier demo project.

For production use, move the Gemini API call to a Vercel Edge Function or serverless function so the key is server-side only.


Free Tier Limits

Provider Limit
Google Gemini 2.0 Flash 1,500 requests/day, 15 RPM, 1M TPM

Mandatory Requirements (Digital Heroes)

  • ✅ Tool works and gives correct output
  • ✅ "Built for Digital Heroes" button links to https://digitalheroesco.com
  • ✅ Builder full name and email visible in footer
  • ✅ Deployed on Vercel Hobby (free)
  • ✅ Public GitHub repo
  • ✅ ₹0 spent — Google AI Studio free tier + Vercel Hobby + GitHub free

Built as part of the Digital Heroes Developer Trial · Stack: React + Vite + Tailwind + Gemini 2.0 Flash (free) + Vercel Hobby

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors