GesturesFast

Fast, customizable, and context-aware mouse gesture navigation for your browser.

GesturesFast is not just another mouse gesture extension. It is engineered with modern web architecture in mind. Whether you are navigating a simple blog or a complex Single Page Application (SPA) with encapsulated web components, GesturesFast delivers a smooth, native-like experience without draining your system resources.

• 🎯 Context-Aware Scrolling: Hover over a specific sidebar, panel, or div. The extension intelligently traverses the DOM tree to scroll only the element under your cursor, not the whole page.
• 🛡️ Shadow DOM Piercing: Works seamlessly on highly complex sites (like Google Gemini, YouTube, etc.) by piercing through encapsulated Web Components to find the true scrollable areas.
• 👻 Stealth Mode: Built for power users. Once you've built muscle memory, toggle on Stealth Mode to hide the visual arrows and let the extension work silently in the background.
• 🎨 Customizable Themes: Personalize your gesture trail! Easily change the arrow and background colors via the Options page to match your browser theme (e.g., a "Matrix" theme with neon green arrows on a black background).
• 📏 Incremental & Absolute Scrolling: Choose between jumping to the absolute Top/Bottom of a page, or doing a smooth "Incremental Scroll" so you never lose your reading spot.
• 🧹 Clean Slate Philosophy: Zero bloatware. The extension installs with an empty gesture dictionary, allowing you to build your own rules from scratch.

Map your gestures (Up, Down, Left, Right) to any of the following browser actions:

• Go to Previous Tab ✨ New
• Open New Tab ✨ New
• Pin / Unpin Tab ✨ New
• Close Current Tab
• Reopen Last Closed Tab

• Go Back / Go Forward
• Reload Page
• Scroll to Top / Bottom
• Scroll Up / Down (Incremental)

1. Go to the Releases page of this repository.
2. Download the GesturesFast-v1.2.5.zip file.
3. Extract the ZIP file into a permanent folder on your computer.
4. Open Google Chrome and navigate to chrome://extensions/.
5. Enable Developer mode in the top right corner.
6. Click Load unpacked and select the folder you just extracted.

1. Clone the repository:

   git clone https://github.com/ahvcxa/GesturesFast.git
   cd GesturesFast

2. Install dependencies & build the project:

   npm install
   npm run build

3. Load the generated dist folder into Chrome via the chrome://extensions/ page.

1. Configure: Open the extension settings to choose your Trigger Button (Middle Click or Right Click).
2. Trigger: Press and hold your chosen button anywhere on a web page.
3. Draw: Drag your mouse to draw a gesture (e.g., Down, Left-Up, etc.).
4. Execute: Release the button to execute the mapped action.

Due to Chrome's strict security policies, content scripts (and therefore mouse gestures) cannot be injected into:

• chrome:// pages (e.g., Settings, Extensions page)
• The Chrome Web Store (chrome.google.com/webstore)
• Local file:/// URLs (unless explicitly allowed in extension settings)

• React & TypeScript (Options UI)
• Tailwind CSS (Styling)
• Vite (Bundler)
• Manifest V3 Architecture

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