Gmail Alias Toolkit

A lightweight browser extension that generates, manages, and organizes Gmail aliases directly from your browser. Create plus-addressed aliases (name+shopping@gmail.com), Gmail dot-trick variations, custom presets, and maintain a searchable history—all without sending your data anywhere.

Features

Alias Generation

• Random alias generator supporting multiple formats: private-mail, alphanumeric, words, and timestamp-based.
• Custom tag generator with user-defined presets for organized alias creation.
• Gmail tricks: dot variations, plus tags, googlemail aliases, and smart combinations.

Alias Management

• Recent aliases table with full-featured search, tag filtering, and sorting.
• Favorites marking and QR code generation for quick sharing.
• Bulk export in CSV and JSON formats for backup and analysis.

Multi-Account Support

• Isolated history, statistics, and favorites per account.
• Seamless account switching without data leakage.

Customization & Accessibility

• Configurable settings: badge counter display, random format selection, auto-save limits, and notifications.
• Preset management for frequently used alias patterns.
• Light and dark mode theme toggle.
• Full data import/export for migration and backup.

Internationalization

• Complete localization with automatic UI translation across all interfaces.

Code Quality

• Comprehensive JSDoc documentation for all functions and components
• Strict TypeScript type checking and anti-pattern detection
• Clean, maintainable code following industry best practices
• Automatic code formatting with Prettier

Privacy

• Data is stored locally in the browser extension storage.
• No analytics or tracking.
• No remote API is required for alias generation.
• Permissions are limited to storage, clipboard writes, context menus, and page access required by the extension context menu.

Load Locally

1. Build or run the extension locally.
2. Open chrome://extensions/.
3. Enable Developer mode.
4. Click Load unpacked.
5. Select .output/chrome-mv3.

For development and build commands, see CONTRIBUTING.md.

Contributing

Please read CONTRIBUTING.md for local setup, checks, project structure, and pull request expectations.

License

MIT. See LICENSE.md.

Support

• Issues: github.com/ePlus-DEV/gmail-alias-toolkit/issues
• Discussions: github.com/ePlus-DEV/gmail-alias-toolkit/discussions
• Email: dev@eplus.dev