Transform your cursor into beautiful, mesmerizing fluid animations that follow your mouse movement across any webpage. This enhanced version includes improved performance, cross-browser compatibility, and extensive customization options.

• Fluid Simulation: Real-time WebGL-powered fluid dynamics
• Mouse Tracking: Smooth, responsive cursor following
• Color Animation: Dynamic color transitions and effects
• Cross-Browser: Works on Chrome, Firefox, Edge, and other Chromium browsers
• Performance Optimized: Adaptive quality and efficient rendering

• 🎛️ Advanced Settings Panel: Intensity, color speed, and quality controls
• ⚡ Performance Mode: Optimized settings for lower-end devices
• 🔧 Auto Quality Adjustment: Adapts to your device's performance
• 📱 Mobile Support: Touch-friendly interactions
• 🌐 Domain Exclusions: Disable on specific websites
• ⌨️ Keyboard Shortcuts: Quick toggle and control
• 💾 Settings Persistence: Your preferences are saved
• 🔍 Context Menu: Right-click controls
• 🚀 Better Error Recovery: Robust error handling

1. Download the extension files
2. Open Chrome Extensions page:
   • Go to chrome://extensions/
   • Enable "Developer mode" (top right toggle)
3. Load the extension:
   • Click "Load unpacked"
   • Select the folder containing the extension files
   • Make sure you're using manifest.json (not manifest_v2.json)

1. Prepare Firefox version:
   • Rename manifest_v2.json to manifest.json
   • Remove the original manifest.json
2. Load in Firefox:
   • Go to about:debugging
   • Click "This Firefox"
   • Click "Load Temporary Add-on"
   • Select the manifest.json file

# Clone or download the repository
git clone https://github.com/splash-cursor/extension.git
cd splash-cursor-extension

# For Chrome development
cp manifest.json manifest_chrome.json

# For Firefox development  
cp manifest_v2.json manifest.json

splash-cursor-extension/
├── manifest.json              # Chrome/Edge Manifest V3
├── manifest_v2.json          # Firefox Manifest V2
├── content.js                # Enhanced content script
├── background.js             # Enhanced background script  
├── popup.html               # Enhanced popup interface
├── popup.js                 # Enhanced popup logic
├── options.html             # Settings page (optional)
├── options.js               # Settings page logic (optional)
├── icons/                   # Extension icons
│   ├── icon16.png
│   ├── icon32.png  
│   ├── icon48.png
│   ├── icon96.png
│   └── icon128.png
└── README.md               # This file

1. Click the extension icon in your browser toolbar
2. Toggle the effect using the "Enable/Disable" button
3. Move your mouse to see the fluid animation
4. Adjust settings using the settings panel

• Intensity: Control the strength of the fluid effect (0-100%)
• Color Speed: How fast colors change and transition (0-100%)
• Fluid Quality: Resolution and detail level (25-100%)
• Performance Mode: Enable for better performance on slower devices

• Ctrl+Shift+S (Windows/Linux) or Cmd+Shift+S (Mac): Toggle effect
• Right-click context menu for quick access

• Domain Exclusions: Right-click → "Exclude this domain"
• Auto-disable: Automatically disables on restricted pages
• Performance Monitoring: Auto-adjusts quality based on FPS

{
  enabled: true,
  intensity: 50,        // Effect strength (0-100)
  colorSpeed: 50,       // Color change speed (0-100)  
  fluidQuality: 75,     // Rendering quality (25-100)
  performance: false    // Performance mode
}

For High-End Devices:

• Quality: 90-100%
• Performance Mode: Off
• Intensity: 70-100%

For Low-End Devices:

• Quality: 25-50%
• Performance Mode: On
• Intensity: 20-50%

• WebGL 1.0 minimum (WebGL 2.0 preferred)
• Hardware acceleration recommended
• Modern browser (Chrome 88+, Firefox 78+, Edge 88+)

• Adaptive Quality: Automatically adjusts based on FPS
• Frame Rate Monitoring: Tracks performance in real-time
• Resource Cleanup: Proper memory management
• Error Recovery: Graceful handling of WebGL context loss

• ✅ Chrome 88+
• ✅ Firefox 78+
• ✅ Edge 88+
• ✅ Opera 74+
• ✅ Safari 14+ (limited support)

Effect not working:

• Check if WebGL is enabled in your browser
• Ensure hardware acceleration is enabled
• Try refreshing the page
• Check browser console for errors

Performance issues:

• Enable Performance Mode in settings
• Lower the Fluid Quality setting
• Close other resource-intensive tabs
• Update your graphics drivers

Extension not loading:

• Verify all files are in the correct directory
• Check for JavaScript errors in developer tools
• Ensure you're using the correct manifest version
• Try reloading the extension

Chrome/Edge:

• Use manifest.json (Manifest V3)
• Check that "Developer mode" is enabled

Firefox:

• Use manifest_v2.json renamed to manifest.json
• Load as temporary add-on for testing

Open browser developer tools (F12) and check for errors:

// Check WebGL support
console.log('WebGL supported:', !!document.createElement('canvas').getContext('webgl'));

// Monitor performance
console.log('Current FPS:', performance.currentFps);

• Storage: Save your settings and preferences
• ActiveTab: Access the current tab for the effect
• ContextMenus: Right-click menu options
• Host Permissions: Apply effects to all websites
• Tabs (optional): Enhanced tab management
• WebNavigation (optional): Domain exclusion features

1. Fork the repository
2. Make your changes
3. Test on multiple browsers
4. Submit a pull request

• Use modern JavaScript (ES6+)
• Add comprehensive error handling
• Include performance optimizations
• Write clear comments and documentation

• Chrome compatibility
• Firefox compatibility
• Mobile/touch support
• Performance on low-end devices
• Error recovery scenarios
• Settings persistence

• ✅ Complete rewrite with enhanced architecture
• ✅ Cross-browser compatibility (Chrome + Firefox)
• ✅ Advanced settings panel with real-time controls
• ✅ Performance monitoring and auto-optimization
• ✅ Improved error handling and recovery
• ✅ Touch support for mobile devices
• ✅ Domain exclusion system
• ✅ Context menu integration
• ✅ Keyboard shortcuts
• ✅ Better WebGL resource management

• ✅ Basic fluid simulation
• ✅ Mouse tracking
• ✅ Simple toggle functionality

• WebGL fluid simulation techniques
• Cross-browser extension development practices
• Performance optimization strategies
• Community feedback and testing

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

• GitHub Repository
• Chrome Web Store (when published)
• Firefox Add-ons (when published)
• Issue Tracker

Made with ❤️ for a more beautiful web experience