Scroll to Top Button

WHAT IT DOES

Scroll to Top Button adds a floating button that lets you instantly return to the top of any page with a single click. The button appears automatically after you scroll past a configurable threshold (default 200px) and disappears when you're near the top. Clicking the button triggers a smooth, animated scroll to the top of the page. The button is fully customizable—choose its position (bottom-right, bottom-left, top-right, top-left), size (28-80px), color, scroll animation speed, and the scroll threshold at which it appears. You can also press the Home key to scroll to the top without clicking the button.

WHERE IT RUNS

The extension runs entirely within your browser's local environment using the BotGentz framework. All scroll detection, button rendering, and animation control occur on your machine without any network requests. No scroll data, page content, or user activity is ever transmitted, uploaded, or stored externally. The tool works on any website and respects the browser's security boundaries, operating within the isolated extension sandbox. The scroll animation uses the browser's requestAnimationFrame for smooth, performant scrolling.

HOW TO USE

Click the extension toolbar icon to open the Scroll to Top Button panel. The button appears automatically on every page. Click "Toggle Button" to show or hide the button. Click "Scroll to Top" to test the scrolling function. Use the color picker to change the button color. Use the size slider (28-80px) to adjust the button diameter. Change the button position using the dropdown (Bottom Right, Bottom Left, Top Right, Top Left). Adjust the "Show after" threshold (0-1000px) to control when the button appears. Adjust the "Scroll speed" (100-1000ms) to control the animation duration. Toggle "Keyboard shortcut (Home)" to enable or disable the Home key shortcut. The panel shows the current status of the button.

THE SCROLL ANIMATION ENGINE — WHY IT WORKS

Most scroll-to-top implementations use simple window.scrollTo(0, 0) or scrollIntoView, which are instant and jarring. This tool uses a custom animation engine with requestAnimationFrame for smooth, controlled scrolling. The engine calculates the current scroll position, determines the total distance to scroll, and applies an easing function (ease-out cubic) to create a natural deceleration effect. The animation duration is configurable from 100ms to 1000ms. The scroll progress is calculated using a time-based interpolation: elapsed time divided by duration, clamped to 0-1, then passed through the easing function 1 - (1 - t)^3. The scroll position at each frame is computed as startScroll * (1 - ease), gradually decreasing to 0. This approach works across all browsers and handles rapid repeated clicks gracefully. The visibility logic uses a scroll threshold to hide the button when near the top, preventing visual clutter.

THE PANEL

The Scroll to Top Button panel is fully draggable by its title bar and remembers its position on screen per website. It snaps to the edges of your browser window for clean alignment. Collapse the panel to a compact icon strip using the minimize button, restoring it with a single click. Resize the panel by dragging any edge or corner; the controls and options adjust proportionally. Press the Escape key to close the panel instantly. The panel maintains independent state for each browser tab, allowing you to customize the button in multiple tabs simultaneously.

PLEASE NOTE

This extension requires the free BotGentz extension framework to be installed and enabled. The button uses a fixed position and may overlap with page content—adjust the position and size to minimize obstruction. The Home key shortcut works on most pages but may conflict with other shortcuts on some sites. The scroll animation may be interrupted if the user scrolls manually during the animation. All scroll data is processed locally and is never transmitted, logged, or shared. The extension requests no network permissions and functions entirely offline. The source code is fully auditable and available for review.