Email Genius - Chrome Extension

A powerful Chrome extension that helps you write professional emails instantly using Google's Gemini API. Perfect for students and working professionals.

🚀 Features

✍️ Quick Compose

Inline Gmail Integration - Write emails directly in Gmail without opening popups
One-Click Access - Quick Compose button appears in Gmail's formatting toolbar
Smart Suggestions - Get instant email drafts based on your description

📧 Multiple Email Types

Generate emails for any occasion:

General correspondence
Follow-up messages
Meeting requests
Thank you notes
Apologies
Introductions
Sales outreach
Status updates

🎨 Customizable Tone

Choose the perfect tone for your audience:

Professional - For formal business communication
Friendly - For colleagues and familiar contacts
Formal - For official and legal matters
Casual - For informal conversations
Default - Balanced and versatile

💬 Smart Reply Generation

Automatically reads email context from conversations
Generates contextually relevant replies
Saves time on repetitive responses

⚙️ Personal Configuration

Store your personal details (name, role, company)
Set default email preferences
Customize signature style
API key management with secure storage

📸 Screenshots

Quick Compose in Gmail and Inline Prompt Box

The Quick Compose button appears in Gmail's formatting toolbar for instant access Type your email description directly in Gmail - no need to switch tabs

Extension Popup

Alternative access via extension popup for more detailed email composition

Settings Page

Configure your API key, personal details, and email preferences

🔧 Installation

Prerequisites

Google Chrome browser (version 88 or higher)
Google Gemini API Key (Get it here)

Steps

Clone or Download the Extension

git clone hhtps://github.com/hk151109/EmailGenius.git
cd EmailGenius

Load Extension in Chrome
- Open Chrome and navigate to chrome://extensions/
- Enable "Developer mode" (toggle in top-right corner)
- Click "Load unpacked"
- Select the EmailGenius folder
Configure API Key
- Click the extension icon in Chrome toolbar
- Click "Settings" or right-click extension icon → "Options"
- Enter your Google Gemini API Key
- Click "Save Settings"
Set Up Your Profile (Optional)
- Fill in your name, role, and company details
- Choose your default email tone
- Save your preferences

📖 User Guide

Method 1: Quick Compose in Gmail (Recommended)

This is the fastest way to generate emails without leaving Gmail.

Open Gmail and click "Compose" or "Reply"
Find the Quick Compose button (✍️ Quick Compose) in the formatting toolbar (leftmost button)
Click the button to show the inline prompt box
Describe your email - e.g., "Follow up on project timeline"
Select email type (optional) - Choose from dropdown
Select tone (optional) - Professional, Friendly, etc.
Click "Generate" or press Enter
Email appears in the compose box automatically
Edit if needed and send!

Method 2: Extension Popup

For more detailed email composition with additional options.

Click the extension icon in Chrome toolbar
Choose "New Email" or "Reply" tab
Enter your prompt - Describe what you need
Configure options:
- Select email type
- Choose tone
- Add recipient (optional)
Click "Generate Email"
Review the generated email
Click "Insert into Gmail" or "Copy to Clipboard"

Method 3: Smart Reply

Generate contextual replies to emails you've received.

Open an email in Gmail
Click "Reply"
Click the extension icon or use Quick Compose
Select "Reply" tab (in popup)
Click "Generate Reply" - The extension reads the email content automatically
Review and send the generated reply

🔄 User Flow Diagram

┌─────────────────────────────────────────────────────────────────┐
│                     User Opens Gmail                            │
└───────────────────────────┬─────────────────────────────────────┘
                            │
                ┌───────────┴───────────┐
                │                       │
        ┌───────▼──────┐        ┌──────▼──────┐
        │   Compose    │        │    Reply    │
        │  New Email   │        │  to Email   │
        └───────┬──────┘        └──────┬──────┘
                │                      │
                └──────────┬───────────┘
                           │
                ┌──────────▼──────────┐
                │  Click Quick        │
                │  Compose Button     │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  Inline Prompt      │
                │  Box Appears        │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  User enters:       │
                │  • Description      │
                │  • Email Type       │
                │  • Tone (optional)  │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  Click Generate     │
                │  or Press Enter     │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  API Call to        │
                │  Gemini             │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  Email Generated    │
                │  & Inserted         │
                └──────────┬──────────┘
                           │
                ┌──────────▼──────────┐
                │  User reviews,      │
                │  edits, and sends   │
                └─────────────────────┘

⚙️ Configuration Options

API Settings

Field	Description	Required
API Key	Your Google Gemini API key	✅ Yes

Personal Information

Field	Description	Example	Required
Full Name	Your name	John Doe	❌ No
Job Title	Your role	Product Manager	❌ No
Company	Your organization	Tech Corp	❌ No
Email	Your email address	[email protected]	❌ No
Phone	Contact number	+1 234 567 8900	❌ No

Email Preferences

Field	Options	Default
Default Tone	Professional, Friendly, Formal, Casual	Professional
Include Signature	Yes/No	Yes

🔐 Privacy & Security

Local Storage Only - Your API key is stored locally in Chrome's secure storage
No Data Collection - We don't collect or store any of your emails or personal information
Direct API Calls - Communication happens directly between your browser and Google's Gemini API
Open Source - Full transparency - inspect the code yourself

🛠️ Technical Details

Technologies Used

Manifest Version: V3
AI Model: Google Gemini (gemini-2.0-flash-exp)
Frontend: HTML, CSS, JavaScript
Storage: Chrome Storage API (Sync)
Permissions:
- storage - Save user preferences
- activeTab - Access active Gmail tab
- scripting - Inject content scripts
- Host permissions for Gmail and Gemini API

File Structure

email-gen/
├── manifest.json          # Extension configuration
├── popup.html            # Extension popup UI
├── popup.js              # Popup logic
├── options.html          # Settings page UI
├── options.js            # Settings logic
├── background.js         # Service worker (API calls)
├── content.js            # Gmail integration script
├── styles.css            # Popup styles
├── userConfig.json       # Default configuration template
└── images/               # Extension icons

❓ Troubleshooting

Button Not Appearing in Gmail

Refresh Gmail - Press F5 to reload the page
Check Extension - Ensure the extension is enabled in chrome://extensions/
Clear Cache - Try clearing browser cache and reloading
Reinstall - Remove and reload the extension

Email Not Generating

Check API Key - Verify your Gemini API key is correct in settings
Check Console - Press F12 and look for errors in the Console tab
API Quota - Ensure you haven't exceeded Gemini API limits
Network Connection - Check your internet connection

Email Not Inserting into Gmail

Refresh Page - Reload Gmail after extension installation
Close Compose - Close and reopen the compose window
Try Popup Method - Use "Copy to Clipboard" instead

Settings Not Saving

Allow Storage - Check Chrome's site settings for storage permissions
Try Again - Close and reopen the settings page
Check Browser - Ensure you're using a supported Chrome version

🔄 Updates & Changelog

Version 1.0.0 (Current)

✅ Initial release
✅ Quick Compose inline integration
✅ Extension popup interface
✅ Smart reply generation
✅ Personal configuration
✅ Multiple email types and tones
✅ Modern, professional UI design

🤝 Contributing

We welcome contributions! Here's how you can help:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📞 Support

Having issues or questions? Here's how to get help:

Check Troubleshooting - Review the troubleshooting section above
Open an Issue - Report bugs on GitHub Issues

🎉 What's Next?

Planned Features

Made with ❤️ for productivity enthusiasts

Star ⭐ this repository if you found it helpful!

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
images		images
screenshots		screenshots
README.md		README.md
background.js		background.js
content.css		content.css
content.js		content.js
manifest.json		manifest.json
options.html		options.html
options.js		options.js
package.json		package.json
popup.html		popup.html
popup.js		popup.js
styles.css		styles.css
userConfig.json		userConfig.json

hk151109/EmailGenius

Folders and files

Latest commit

History

Repository files navigation