Browser Requirements
Rate is a Chrome extension compatible with Chromium-based browsers:
| Browser | Supported |
|---|
| Google Chrome | Yes |
| Brave | Yes |
| Edge | Yes |
| Opera | Yes |
| Firefox | Not yet |
| Safari | Not yet |
Installation
From Chrome Web Store
Open the Chrome Web Store
Navigate to the Rate extension page on the Chrome Web Store.
Click Add to Chrome
Click the Add to Chrome button and confirm the installation when prompted.
Pin the Extension
Click the puzzle piece icon in the Chrome toolbar, then click the Pin icon next to Rate. This keeps the extension icon visible in your toolbar for quick access.
Manual Installation (Developer Mode)
If you are building from source or testing a pre-release version:
Build the Extension
Clone the repository and build:git clone <repository-url>
cd rate-extension
npm install
npm run build
Open Extensions Page
Navigate to chrome://extensions in your browser.
Enable Developer Mode
Toggle Developer mode in the top-right corner.
Load Unpacked
Click Load unpacked and select the dist folder from the build output.
Pin the Extension
Pin the Rate icon in your toolbar for easy access.
First Launch
After installation, clicking the Rate icon in your toolbar opens the extension popup. On first launch, you are guided through the onboarding flow:
- Welcome screen - Introduction to Rate
- Password setup - Create a secure password to protect your wallet
- Nostr key setup - Generate a new Nostr keypair or import an existing one
- Node connection - Connect to your RGB Lightning Node
- Ready - Your wallet is set up and ready to use
See Getting Started for a detailed walkthrough.
Permissions
Rate requests the following Chrome extension permissions:
| Permission | Purpose |
|---|
| Storage | Encrypted wallet data stored locally |
| Active Tab | Inject WebLN provider into web pages |
| Scripting | Content script for DApp connectivity |
Rate stores all data locally in your browser using chrome.storage.local. No data is sent to external servers except for communication with your RGB Lightning Node and the optional maker API.
Updating
Rate updates automatically through the Chrome Web Store. For manual installations, pull the latest code, rebuild, and reload the extension on chrome://extensions.
Uninstalling
To remove Rate:
- Right-click the Rate icon in your toolbar
- Select Remove from Chrome
- Confirm the removal
Uninstalling the extension removes all locally stored wallet data. Make sure you have backed up your Nostr keys and any important data before uninstalling.
