Unleash Browser Extension (unleash-bex)

Unleash browser extension. Easily see notifications and feature toggles on your browser.

Currently supports Unleash Enterprise v4.22 or above.

Screen.Recording.2023-03-08.at.18.59.11.mp4

Getting Started

🎁 Install

This extension should be compatible with Chrome, Firefox and other Chromium-based browsers.

You can access the latest build in Releases. Simply download the ZIP file and extract it somewhere in your computer.

After downloading the latest build, you can install it in Chrome by following these steps:

1. In Chrome, navigate to chrome://extensions.
2. Toggle "Developer Mode".
3. Click “Load unpacked”. This will present you with the folder selection dialog. Navigate to and select the extension folder.
4. You should now see the extension in Chrome.

For Firefox, you can follow these steps:

1. In Firefox, navigate to about:debugging.
2. Click on "This Firefox".
3. Click “Load Temporary Add-on…”. This will present you with the file selection dialog. Navigate to and select the manifest.json file inside the extension folder.
4. You should now see the extension in Firefox.

For other browsers, we recommend following the appropriate browser documentation on how to add a browser extension to that particular browser.

🔧 Settings

After installing the extension, click it to open. Since this is your first time using the extension, you won't have access to most features and instead you'll be redirected to the settings page.

You should enter your Unleash instance URL on the first field.

If you're already logged in in that instance, this should be enough. The browser extension should be able to use the same Unleash session cookie that was set when you logged in.

However, if you'd like to have access at all times, even when your session expires or you log out, we suggest setting a token in the second field. Unleash PATs are great for this use case. No matter the token you set, the session cookie will always take precedence.

You can also change the notification refresh interval, setting a value (in seconds) of how often to check for new notifications.

✨ Features

🔔 Notifications

Access your Unleash notifications from your browser's toolbar. Notifications will be fetched from Unleash on the interval you set when configuring the extension. By clicking any of them, you'll get redirected to the respective page in your Unleash instance.

The extension will also show the total unread notifications in a badge, so you can easily see if there are any new notifications:

Note: We highly suggest pinning the extension to the toolbar:

🚦 Toggles

Control your feature toggles and quickly toggle a feature on or off. You can select the project and environment on the top right. By clicking any of the feature toggle names, you'll get redirected to the respetive page in your Unleash instance.

The change requests feature is currently not supported on this browser extension. In case you try to toggle a feature on a project that has change requests enabled for an environment, you'll see a tooltip with more information:

👀 Tooltips

Improve interactivity whenever you encounter a link to your Unleash instance while browsing. Easily see the current state of a feature toggle for a specific environment and toggle it right from the tooltip.

Note: Currently only links to feature toggles are supported.

👨‍💻 Development

Built using Quasar Framework (Vue.js 3) BEX mode.

Also uses Pinia and Axios.

You can read more about how to use the Unleash API by following the official docs.