Skip to main content

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.

The Chrome extension works with Chrome, Edge, Brave, and other Chromium-based browsers.

​
Installation

1

Visit the Chrome Web Store

Navigate to the Better Hub extension page on the Chrome Web Store.
If the extension isn’t published yet, use the manual installation method.
2

Add to Chrome

Click Add to Chrome, then Add extension in the confirmation dialog.
3

Pin the extension (optional)

Click the puzzle piece icon in your toolbar and pin Better Hub for easy access to the settings popup.

​
Configuration

1

Open the extension popup

Click the Better Hub icon in your browser toolbar.
2

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)
Click Save after entering the URL.
3

Enable redirects

The toggle switch at the top controls whether redirects are active:
  • Green (on): GitHub URLs redirect to Better Hub
  • Gray (off): Extension is paused, no redirects happen
The status indicator shows “Redirecting” or “Paused”.
Changes take effect immediately — no reload required. Just navigate to any GitHub URL to test.

​
Usage

Once configured, the extension works automatically:
  1. Visit any GitHub URL — from links in emails, Slack, documentation, etc.
  2. Automatic redirect — You’ll be taken to the equivalent page in Better Hub
  3. 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

Click “Route mappings” in the popup to see exactly how GitHub URLs map to Better Hub routes.

​
Permissions Explained

The Chrome extension requires these permissions:
PermissionPurpose
storageStore your instance URL and enabled/disabled state
declarativeNetRequestRedirect GitHub URLs to Better Hub
activeTabCheck if current tab is on GitHub (for popup UI)
webNavigationHandle edge cases like github.com homepage redirect
host: github.comRequired 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.

​
Troubleshooting

  • 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
  • Check that you’re visiting a supported GitHub URL (not settings/marketplace/etc.)
The gray icon means redirects are currently disabled. Click the icon and toggle redirects back on.
  • Make sure the URL starts with http:// or https://
  • Remove any trailing slashes from the URL
  • Try reloading the extension from chrome://extensions/
This is a known edge case. The extension detects the GitHub logout flow and temporarily disables redirects to let the logout complete successfully.

​
Uninstall

To remove the extension:
  1. Go to chrome://extensions/
  2. Find Better Hub in the list
  3. Click Remove
  4. Confirm removal
Your settings (instance URL, enabled state) are deleted when you uninstall.

Build docs developers (and LLMs) love

Get started for freeTalk to us