Installation

There are three ways to install Nanobrowser: from the Chrome Web Store for a stable experience, manually for the latest features, or by building from source for development.

This is the easiest way to get started with the latest stable version of Nanobrowser.

  1. Visit the Nanobrowser page on the Chrome Web Store.
  2. Click the "Add to Chrome" button.
  3. Confirm the installation when prompted.

Note: New versions submitted to the Chrome Web Store may be delayed due to Google's review process. For immediate access to the latest features, consider installing manually.

Method 2: Manually Install the Latest Version

To use the most recent release with all the newest features, you can load the extension manually.

  1. Download the Extension Go to the official GitHub releases page and download the latest nanobrowser.zip file.

  2. Unzip the File Extract the contents of nanobrowser.zip to a permanent folder on your computer.

  3. Load the Extension in Chrome

    • Open Chrome and navigate to chrome://extensions/.
    • Enable Developer mode using the toggle in the top-right corner.
    • Click the Load unpacked button in the top-left corner.
    • Select the unzipped nanobrowser directory (the one containing manifest.json).

  4. Pin the Extension Click the puzzle piece icon in your Chrome toolbar and pin Nanobrowser for easy access.

Method 3: Build from Source (For Developers)

If you want to contribute to Nanobrowser or build it yourself, follow these steps.

Prerequisites

  • Node.js: Version 22.12.0 or higher is required. We recommend using a version manager like nvm. 

    nvm use

  • pnpm: Version 9.15.1 or higher is required. 

    npm install -g pnpm

Build Steps

  1. Clone the Repository 

    git clone https://github.com/nanobrowser/nanobrowser.git
cd nanobrowser

  2. Install Dependencies 

    pnpm install

  3. Build the Extension This command cleans the previous build and creates a new production-ready build in the dist/ directory. 

    pnpm build

  4. Load the Extension Follow the same steps as in "Method 2: Manually Install the Latest Version", but select the dist/ directory at the root of the project.

For more details on development workflows, see the Contributing guide.