📧 Gmail Glance

A lightweight, visually striking Chrome extension built with Manifest V3 that allows you to quickly check your Gmail inbox, view unread counts, and manage emails directly from your browser toolbar.

✨ Features

• Live Background Syncing: Automatically fetches your unread email count every 5 minutes and updates the extension badge.
• Vaporwave Dark Mode UI: A custom-designed, high-contrast dark theme with neon accents to reduce eye strain.
• Instant Inbox Management: View the sender, subject, and snippet of your latest emails, and use the inline ✓ button to mark them as read instantly.
• Seamless Authentication: Utilizes the native chrome.identity API for secure, frictionless Google SSO.

🛠️ Technology Stack

• HTML/CSS/JavaScript: Pure vanilla web technologies.
• Chrome Extension API: Built using the modern Manifest V3 standard (service_workers, alarms, action, identity).
• Google REST API: Interfaces directly with the gmail/v1 endpoints.

🚀 Setup & Installation (Local Development)

Because this extension interacts with the private Gmail API, you must generate your own Google Cloud Client ID to run it locally. For security, real Client IDs are never committed to this repository.

1. Google Cloud Configuration

1. Go to the Google Cloud Console.
2. Create a New Project and navigate to APIs & Services > Library.
3. Search for the Gmail API and click Enable.
4. Go to APIs & Services > OAuth consent screen.
   • Select External and fill in the required app details.
   • Under the Test users section, add the exact email address you plan to use for testing.
5. Go to APIs & Services > Credentials.
   • Click Create Credentials > OAuth client ID.
   • Select Chrome extension as the application type.
   • Keep this window open, you will need to paste your Extension ID here shortly.

2. Loading the Extension & Linking the ID

1. Clone this repository to your local machine using your terminal: git clone https://github.com/YOUR-USERNAME/GmailGlance.git
2. In the root directory, duplicate the manifest.example.json file and rename the copy to manifest.json. (Note: manifest.json is safely ignored by Git).
3. Open Google Chrome and navigate to chrome://extensions/.
4. Toggle Developer mode on (top right corner).
5. Click Load unpacked and select your cloned GmailGlance folder.
6. Copy the Extension ID generated by Chrome.
7. Go back to your Google Cloud Console window and paste the Extension ID into the OAuth Client ID creation screen. Click Create.
8. Copy the resulting Client ID (it ends in .apps.googleusercontent.com).
9. Open your new manifest.json file and replace "YOUR_CLIENT_ID_HERE" with your actual Client ID.

3. Finalizing the Connection

1. Go back to chrome://extensions/ and click the Reload button on the Gmail Glance card.
2. Pin the extension to your toolbar, click the icon, and connect to Gmail.
3. Note: Because your app is in testing mode, Google will show an unverified app warning. Click Advanced > Go to Gmail Glance (unsafe) to proceed.

🔒 Privacy & Security

This extension runs entirely locally within your browser.

• No email data is ever stored, cached, or transmitted to any third-party servers.
• Authentication is handled directly between your browser and Google's OAuth servers.
• The extension only requests the gmail.modify scope, which is strictly used to read message metadata and remove the UNREAD label.
• The .gitignore file ensures your private manifest.json (containing your Client ID) and local IDE caches (like .vs/) are never pushed to the public repository.

📄 License

This project is licensed under the MIT License.