Skip to main content

Installation

There are two ways to install Graytool in your Chrome browser.

Prerequisites​

  • Google Chrome (or a Chromium-based browser)
  • Node.js (v18+) and npm

Steps​

  1. Clone the project:
git clone https://github.com/bozkurtemre/graytool.git
cd graytool
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

  1. Load into Chrome:

    • Navigate to chrome://extensions/ in Chrome
    • Enable "Developer mode" in the top right
    • Click "Load unpacked"
    • Select the src folder in the project

  2. Done! The Graytool icon will appear in the toolbar.

Updating​

After code changes:

npm run build

Then click the reload (🔄) button on the Graytool card in chrome://extensions/.

Production Build​

Optimized build for distribution:

npm run build:prod

This produces minified files without source maps.

Watch Mode (Development)​

Automatic rebuild on file changes:

npm run dev
tip

In watch mode, you still need to reload the Chrome extension after each change. Use the reload button on the chrome://extensions/ page.

Troubleshooting​

Extension won't load​

  • Make sure you selected the src folder (not the project root)
  • Verify that npm run build completed successfully
  • Ensure Chrome is up to date

Permission errors​

Graytool requests separate permissions for each URL pattern. When you add your first URL pattern, Chrome will show a permission dialog. You need to click "Allow".