CleanSweep Mail - Support

Overview

CleanSweep Mail is a Chrome extension crafted by a solo developer to help you manage your Gmail inbox effortlessly. With one click, you can permanently delete emails from the Promotions, Social, and Spam categories, keeping your inbox clean and organized.

Version: 1.0.6
Last Updated: June 28, 2025
Developer: Sanjhai Prakash
Contact: sanjhaiprakash18@gmail.com

Features

• One-Click Cleaning: Permanently delete emails from Promotions, Social, and Spam with a single button.
• Google Sign-In: Securely authenticate with your Google account to manage your Gmail.
• Real-Time Email Counts: See the number of emails in Promotions, Social, and Spam categories.
• User-Friendly Interface: Access CleanSweep Mail via a popup from the Chrome toolbar.
• Dark Mode: Toggle between light and dark themes for a comfortable experience.
• Progress Tracking: Monitor email deletion with a progress bar and status updates.
• Secure Authentication: Built with Google's OAuth 2.0 for safe Gmail access.

How to Use CleanSweep Mail

Installation

1. Go to the Chrome Web Store and search for "CleanSweep Mail."
2. Click Add to Chrome and confirm installation.
3. The CleanSweep Mail icon will appear in your Chrome toolbar.

Getting Started

1. Sign In:
   • Click the CleanSweep Mail icon in the Chrome toolbar to open the popup.
   • Click Sign in with Google and follow the prompts to authenticate.
   • Grant the required permissions to access your Gmail account.
2. View Email Counts:
   • After signing in, the popup displays email counts for Promotions, Social, and Spam.
   • Click Refresh to update counts manually.
3. Clean Your Inbox:
   • Click Clean Inbox to start permanently deleting emails.
   • Confirm the deletion in the dialog showing the total emails to be deleted.
   • Track progress via the progress bar and status messages.
4. Sign Out:
   • Click Sign Out in the popup to log out.

Permissions Explained

CleanSweep Mail requires these permissions to work:

• Identity: For secure Google authentication via OAuth 2.0.
• Storage: To save authentication tokens and preferences (e.g., theme).
• ActiveTab: To interact with the Gmail tab.
• Host Permissions (https://mail.google.com/*, https://www.googleapis.com/*): To access Gmail and Google APIs.
• Gmail Scopes:
  • gmail.modify: To delete emails permanently.
  • gmail.readonly: To fetch email counts.
  • userinfo.profile and userinfo.email: To show your profile picture, name, and email.
  • gmail.compose: Included for potential future features (not currently used).

Your data is handled securely and never shared with third parties.

Troubleshooting

Common Issues

1. "Sign-in failed" or "Session expired":
   • Fix: Click Sign Out, then sign in again, ensuring all permissions are granted.
   • Cause: Expired or revoked authentication token.
2. Email Counts Not Updating:
   • Fix: Click Refresh. If unresolved, sign out and back in.
   • Cause: Cached data or API issues.
3. "Error: Forbidden" or "Authentication expired":
   • Fix: Sign out and sign in again, ensuring permissions are granted.
   • Cause: Insufficient permissions or invalid token.
4. Deletion Stuck or Slow:
   • Fix: Wait, as large inboxes take longer. Retry if needed.
   • Cause: Gmail API rate limits or high email volume.
5. Dark Mode Issues:
   • Fix: Toggle the dark mode switch in the popup. Clear browser cache if needed.
   • Cause: Extension conflicts or cached settings.

Still Stuck?

Try these steps:

• Disable other Chrome extensions to check for conflicts.
• Reinstall CleanSweep Mail from the Chrome Web Store.
• Clear browser cache and cookies.

Frequently Asked Questions (FAQs)

1. Does CleanSweep Mail permanently delete emails?

   Yes, emails in Promotions, Social, and Spam are permanently deleted and cannot be recovered.

2. Is my data secure?

   Yes, CleanSweep Mail uses Google's OAuth 2.0. Data is only used for functionality and not stored or shared.

3. Can I clean specific categories?

   Not yet—CleanSweep Mail deletes emails from Promotions, Social, and Spam together. Selective deletion may come in future updates.

4. Why sign in with Google?

   Google sign-in is needed to access the Gmail API for email counts and deletion.

5. How do I get support?

   Email sanjhaiprakash18@gmail.com with details of your issue, including error messages and steps to reproduce.

Privacy Policy

CleanSweep Mail prioritizes your privacy:

• Uses Google OAuth 2.0 for secure authentication.
• Accesses only necessary Gmail data (counts and deletion).
• Stores tokens locally in Chrome's secure storage.
• Does not collect or share personal data.

Contact sanjhaiprakash18@gmail.com for details.

Feedback and Suggestions

As a solo developer, I value your input! Send suggestions or feature requests to sanjhaiprakash18@gmail.com.

Changelog

Version 1.0.6 (June 28, 2025)

• Initial release with one-click permanent deletion for Promotions, Social, and Spam emails.
• Added popup interface.
• Implemented Google OAuth 2.0 authentication.
• Included dark mode and progress tracking.

Contact

For support, bugs, or feature requests, reach out to me:

Thank you for using CleanSweep Mail! I’m dedicated to keeping your inbox clean and your experience smooth.