Skip to content

A lightweight Chrome extension to create and launch website groups instantly — fast, elegant, and intuitive.

Notifications You must be signed in to change notification settings

anelkamd/WebCluster

Repository files navigation

🌐 WebCluster - Cross-Browser Extension

WebCluster is a powerful, cross-browser web extension that lets you create, organize, and launch groups of websites with a single click. Built for maximum compatibility across Chrome, Firefox, Edge, and Safari.

✨ Key Features

  • 🎯 One-click launching of website groups
  • 🎨 Custom colors for visual organization
  • 🔄 Cross-browser compatible (Chrome, Firefox, Edge, Safari)
  • 📱 Responsive design for any screen size
  • 📤 Export/Import functionality for backup and sharing
  • 🖱️ Drag-and-drop reordering of groups
  • Real-time tracking of opened tabs
  • 🎯 Clean, modern interface with smooth animations

🚀 Installation

Chrome/Edge (Manifest V3)

  1. Download the extension files
  2. Open chrome://extensions/ or edge://extensions/
  3. Enable "Developer mode"
  4. Click "Load unpacked" and select the extension folder

Firefox (Manifest V2 + WebExtensions API)

  1. Download the extension files
  2. Rename manifest-firefox.json to manifest.json
  3. Open about:debugging#/runtime/this-firefox
  4. Click "Load Temporary Add-on"
  5. Select the manifest.json file

Safari (Future Support)

Safari support coming soon with additional manifest configuration.

🔧 Technical Features

Cross-Browser Compatibility

  • Manifest V3 for modern Chromium browsers
  • Manifest V2 compatibility for Firefox
  • WebExtensions API polyfill for unified development
  • Universal storage using chrome.storage.local / browser.storage.local
  • Tab management across different browser APIs

Modern Development Practices

  • Clean, modular JavaScript (ES6+)
  • Responsive CSS with modern features
  • Accessibility-first design
  • Performance optimized animations
  • Error handling and graceful fallbacks

Security & Privacy

  • Minimal permissions required
  • Local storage only (no external data transmission)
  • Content Security Policy compliant
  • No tracking or analytics

🎯 Usage

  1. Create Groups: Click the extension icon and add a group name with URLs
  2. Customize: Choose colors and organize your groups
  3. Launch: Click the play button to open all websites in a group
  4. Manage: Edit, reorder, or delete groups as needed
  5. Sync: Export your configuration to share across devices

🛠️ Development

File Structure

extension/
├── manifest.json              # Chrome/Edge manifest (V3)
├── manifest-firefox.json      # Firefox manifest (V2)
├── webextension-polyfill.js   # Cross-browser compatibility
├── background.js              # Service worker / background script
├── popup.html                 # Extension popup interface
├── popup.js                   # Popup functionality
├── styles.css                 # Responsive styling
└── icons/                     # Extension icons

Key Technologies

  • WebExtensions API for browser integration
  • Vanilla JavaScript for maximum compatibility
  • CSS Grid/Flexbox for responsive layouts
  • Local Storage API for data persistence
  • Drag & Drop API for interface interactions

🌟 Advanced Features

Tab Management

  • Automatic tab tracking by group
  • Close all tabs in a group with one click
  • Visual indicators for active groups
  • Cascade opening with customizable delays

Data Management

  • JSON export/import for configuration backup
  • Automatic migration of legacy data formats
  • Cross-browser data synchronization support
  • Robust error handling and data validation

User Experience

  • Smooth animations and micro-interactions
  • Keyboard shortcuts support
  • Context-aware interface states
  • Progressive disclosure of advanced features

🔍 Browser Support

Browser Manifest Status Notes
Chrome V3 ✅ Full Latest APIs
Edge V3 ✅ Full Latest APIs
Firefox V2 ✅ Full WebExtensions API
Safari V2 🔄 Planned Additional config needed

📝 Version History

v1.0.0 (Current)

  • Cross-browser compatibility
  • Manifest V3 support
  • Modern UI with animations
  • Export/import functionality
  • Drag-and-drop reordering
  • Tab management features

🤝 Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests for any improvements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Created by Anelka - Building productivity tools with simplicity and elegance.


🧡 Thank you for using WebCluster!

Visit our landing page for more information and updates.

About

A lightweight Chrome extension to create and launch website groups instantly — fast, elegant, and intuitive.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published