The Firefox extension works with Firefox and Firefox-based browsers. It requires Firefox 109 or later.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/better-auth/better-hub/llms.txt
Use this file to discover all available pages before exploring further.
Installation
- Firefox Add-ons
- Manual Installation
Visit Firefox Add-ons
Navigate to the Better Hub extension page on the Firefox Add-ons site.
If the extension isn’t published yet, use the manual installation method.
Configuration
Set your instance URL
Enter your Better Hub instance URL in the Instance URL field.
- Default:
https://better-hub.com - Self-hosted: Use your deployment URL (e.g.,
https://hub.yourcompany.com)
Changes take effect immediately. Navigate to any GitHub URL to test the redirects.
Usage
Once configured, the extension works automatically:- Visit any GitHub URL — from links in emails, Slack, documentation, etc.
- Automatic redirect — You’ll be taken to the equivalent page in Better Hub
- Seamless navigation — All internal GitHub links redirect as you browse
Temporarily Disable
To use GitHub directly without uninstalling:- Click the extension icon and toggle the switch off
- The icon turns gray to indicate redirects are paused
- Toggle back on when you want to resume using Better Hub
View Route Mappings
Expand “Route mappings” in the popup to see exactly how GitHub URLs map to Better Hub routes.Permissions Explained
The Firefox extension requires these permissions:| Permission | Purpose |
|---|---|
storage | Store your instance URL and enabled/disabled state |
declarativeNetRequestWithHostAccess | Redirect GitHub URLs to Better Hub (Firefox-specific API) |
activeTab | Check if current tab is on GitHub (for popup UI) |
host: github.com | Required to intercept GitHub URLs |
The extension only runs on
github.com and does not access any other websites. It does not read page content or send data externally.Firefox-Specific Details
Manifest Differences
The Firefox version uses Manifest V3 with Firefox-specific adaptations:- Uses
declarativeNetRequestWithHostAccessinstead of separate permissions - Background scripts instead of service workers
- Includes
browser_specific_settingsfor add-on ID and minimum version - Requires Firefox 109+ for full Manifest V3 support
Extension ID
The extension uses the IDbetter-hub@extension for Firefox’s add-on system.
Troubleshooting
Redirects aren't working
Redirects aren't working
- Check that the toggle is on (green) in the popup
- Verify your instance URL is correct and doesn’t have a trailing slash
- Try disabling and re-enabling the extension from
about:addons - Ensure you’re visiting a supported GitHub URL (not settings/marketplace/etc.)
- Check that you’re running Firefox 109 or later
Extension icon is gray
Extension icon is gray
The gray icon means redirects are currently disabled. Click the icon and toggle redirects back on.
Can't save instance URL
Can't save instance URL
- Make sure the URL starts with
http://orhttps:// - Remove any trailing slashes from the URL
- Try reloading the extension from
about:addons
Temporary add-on disappeared after restart
Temporary add-on disappeared after restart
This is expected behavior. Temporary add-ons must be reloaded after each browser restart. Install the signed version from Firefox Add-ons for permanent installation.
Firefox version too old
Firefox version too old
The extension requires Firefox 109 or later for Manifest V3 support. Update Firefox to the latest version.
Uninstall
To remove the extension:- Go to
about:addons - Find Better Hub in the Extensions list
- Click the three-dot menu (⋯) and select Remove
- Confirm removal