WebExt Deploy

The ultimate automation tool for deploying to multiple extension stores simultaneously!

Made by Avi

Supported stores:

Chrome Web Store
Firefox Add-ons
Edge Add-ons
Opera Add-ons

Core packages/APIs used

Playwright - for fetching the Opera cookies
Chrome Web Store Publish API
Microsoft Edge Publish API v1.1
Firefox Add-ons Store Submission API
Opera Store API

Installing

npm i -D web-ext-deploy
# or
pnpm i -D web-ext-deploy
# or
yarn add -D web-ext-deploy

or install globally

npm i -g web-ext-deploy
# or
pnpm i -g web-ext-deploy
# or
yarn global add web-ext-deploy

Deployment to Chrome Web Store: follow this guide
Deployment to Edge Add-ons Store: follow this guide

Usage

1. Obtain the relevant cookie(s) of the publisher's account:

Disclaimer: I do NOT take any responsibility for leaked cookies or credentials.

Opera: sessionid, csrftoken

If you have a hard time obtaining the cookie(s), you can run:

web-ext-deploy --get-cookies=opera

Note that for the Chrome Web Store, you'll use the Chrome Web Store Publish API
As for the Edge Add-ons Store, you'll use the Microsoft Edge Publish API

2. Decide how to access the data & credentials

.env files method
CLI arguments method
Node.js API method

`.env` files method

Use the .env snippet(s) relevant to your extension
Include each one in your root directory
Make sure to have *.env or chrome.env, firefox.env, edge.env, opera.env in your .gitignore
Note that by using the aforementioned --get-cookies, it automatically added the .env items to it

Next, in the CLI:

web-ext-deploy --env

Additional arguments for the `.env` mode:

--verbose boolean?
If specified, the steps of every store will be logged to the console.
--publish-only Array<"chrome" | "firefox" | "edge" | "opera">?
If specified, for each specified store that has an .env file, it will be deployed
E.g. if you have chrome.env, firefox.env, opera.env, and you run:
```
web-ext-deploy --env --publish-only=chrome firefox
```
It will only deploy to Chrome Web Store and Firefox Add-ons Store
--zip string?
If specified, it will be used for every .env that the ZIP is not specified
--firefox-changelog string?
If specified and firefox.env exists, it will be used to provide changelog for the Firefox users
New lines (\n) are supported
--firefox-dev-changelog string?
If specified and firefox.env exists, it will be used to provide changelog for the Firefox Add-ons reviewers
New lines (\n) are supported
--edge-dev-changelog string?
If specified and edge.env exists, it will be used to provide changelog for the Edge Add-ons reviewers
New lines (\n) are supported
--opera-changelog string?
If specified and opera.env exists, it will be used to provide changelog for the Opera users
New lines (\n) are supported

Notes:

Chrome Web Store:
- REFRESH_TOKEN, CLIENT_ID, CLIENT_SECRET - follow this guide
- EXT_ID - Get it from https://chrome.google.com/webstore/detail/EXT_ID, e.g. https://chrome.google.com/webstore/detail/fcphghnknhkimeagdglkljinmpbagone
Firefox Add-ons store:
- EXT_ID - Get it from https://addons.mozilla.org/addon/EXT_ID
- ZIP - The relative path to the ZIP. You can use {version}, which will be replaced by the version entry from your package.json
- ZIP_SOURCE - Optional. The relative path to the ZIP that contains the source code of your extension, if applicable
- JWT_ISSUER, JWT_SECRET - obtain from the Developer Hub
Edge Add-ons store:
- CLIENT_ID, API_KEY - follow this guide
- PRODUCT_ID - Get it from https://partner.microsoft.com/en-us/dashboard/microsoftedge/PRODUCT_ID
- ZIP - You can use {version}
Opera Add-ons store:
- PACKAGE_ID - Get it from https://addons.opera.com/developer/package/PACKAGE_ID
- ZIP - You can use {version}
- Source code inspection: The Opera Add-ons reviewers require inspecting your extension's source code
  This can be done by doing one of the following:
  - Uploading the ZIP that contains the source code to a public folder on a storage service (e.g. Google Drive)
  - Making the extension's code open source on a platform like GitHub, with clear instructions on the README.md, and then linking to its repository
The keys are case-insensitive, as they will be camel-cased anyway

Possible `.env` files

`chrome.env`

REFRESH_TOKEN="RefreshToken"
CLIENT_ID="ClientID"
CLIENT_SECRET="ClientSecret"
ZIP="dist/some-zip-v{version}.zip"
EXT_ID="ExtensionID"

`firefox.env`

JWT_ISSUER="JwtIssuer"
JWT_SECRET="JwtSecret"
ZIP="dist/some-zip-v{version}.zip"
ZIP_SOURCE="dist/some-zip-source-v{version}.zip"
EXT_ID="ExtensionID"

`edge.env`

CLIENT_ID="ClientID"
API_KEY="ApiKey"
ZIP="dist/some-zip-v{version}.zip"
PRODUCT_ID="ProductID"

`opera.env`

SESSIONID="sessionid_value"
CSRFTOKEN="csrftoken_value"
ZIP="dist/some-zip-v{version}.zip"
PACKAGE_ID=123456

CLI arguments method

Use it only if your extension's code will not be publicly available

web-ext-deploy --chrome-zip="some-zip-v{version}.zip" --chrome-ext-id="ExtensionID" --firefox-zip="some-zip-v{version}.zip" --firefox-ext-id="ExtensionID"

CLI API

Stores:

Chrome Web Store
Firefox Add-ons
Edge Add-ons
Opera Add-ons

Options:

--verbose boolean?
If specified, the steps of every store will be logged to the console

--zip string?
If specified, it will be used for every store that the zip is not specified
For example, in

web-ext-deploy --zip="zip-v{version}.zip" --chrome-refresh-token="refreshToken" --chrome-client-id="clientId" --chrome-client-secret="clientSecret" --firefox-jwt-issuer="jwtIssuer" --firefox-jwt-secret="jwtSecret" --edge-client-id="clientId" --edge-api-key="apiKey" --edge-zip="some-zip-v{version}.zip"

the zip-v{version}.zip will be used for the Chrome Web Store and the Firefox Add-ons

Chrome Web Store CLI

# Get it from https://chrome.google.com/webstore/detail/EXT_ID, e.g. https://chrome.google.com/webstore/detail/fcphghnknhkimeagdglkljinmpbagone
--chrome-ext-id: string

# Get them by following https://github.com/fregante/chrome-webstore-upload-keys
--chrome-refresh-token: string
--chrome-client-id: string
--chrome-client-secret: string

# The relative path from the root to the ZIP
# You can use {version}, which will be replaced by the `version` entry in your `package.json`
--chrome-zip: string

Get your --chrome-refresh-token, --chrome-client-id and --chrome-client-secret by following this guide
Example:

web-ext-deploy --chrome-ext-id="ExtensionID" --chrome-refresh-token="RefreshToken" --chrome-client-id="ClientID" --chrome-client-secret="ClientSecret" --chrome-zip="some-zip-v{version}.zip"

Firefox Add-ons CLI

# The extension ID from the store URL, e.g. https://addons.mozilla.org/addon/EXT_ID
--firefox-ext-id: string
  
# Get them from https://addons.mozilla.org/developers/addon/api/key
--firefox-jwt-issuer: string
--firefox-jwt-secret: string
  
# The relative path from the root to the ZIP
# You can use {version}, which will be replaced by the `version` entry from your `package.json`
--firefox-zip: string
  
# If applicable, the relative path from the root to the ZIP source
# You can use {version}, which will be replaced by the `version` entry from your `package.json`
--firefox-zip-source?: string
  
# A description of the changes in this version, compared to the previous one
# It's recommended to use instead --firefox-changelog , so it stays up to date
--firefox-changelog?: string
  
# A description of the technical changes made in this version, compared to the previous one
# This will only be seen by the Firefox Addons reviewers
# It's recommended to use instead --firefox-dev-changelog , so it stays up to date
--firefox-dev-changelog?: string

Example:

web-ext-deploy --firefox-ext-id="ExtensionID" --firefox-jwt-issuer="JwtIssuer" --firefox-jwt-secret="JwtSecret" --firefox-zip="dist/some-zip-v{version}.zip" --firefox-changelog="Changelog\nWith line breaks" --firefox-dev-changelog="Changelog for reviewers\nWith line breaks"

Edge Add-ons CLI

# The product ID from the Edge Add-ons Dashboard, e.g.
# https://partner.microsoft.com/en-us/dashboard/microsoftedge/PRODUCT_ID
--edge-product-id: string

# Get them by following https://github.com/avi12/web-ext-deploy/blob/main/EDGE_PUBLISH_API.md
--edge-client-id: string
--edge-api-key: string

# The relative path from the root to the ZIP
# You can use {version}, which will be replaced by the `version` entry in `package.json`
--edge-zip: string

# A description of the technical changes made in this version, compared to the previous one
# This will only be seen by the Edge Add-ons reviewers
# You can use \n for new lines
--edge-dev-changelog?: string

Example:

web-ext-deploy --edge-product-id="ProductID" --edge-client-id="clientId" --edge-api-key="apiKey" --edge-zip="dist/some-zip-v{version}.zip" --edge-dev-changelog="Changelog for reviewers\nWith line breaks"

Note:
Due to the way the Edge dashboard works, when an extension is being reviewed or its review has just been canceled, it will take about a minute until a cancellation will cause its state to change from "In review" to "In draft", after which the new version can be submitted
Therefore, if you publish after you had just published/canceled, expect to wait a little longer

Opera Add-ons CLI

# The extension ID from the Opera Add-ons Dashboard, e.g.
# https://addons.opera.com/developer/package/PACKAGE_ID
--opera-package-id: number

# If you have a hard time obtaining them, run: web-ext-deploy --get-cookies=opera
--opera-sessionid: string
--opera-csrftoken: string

# The relative path from the root to the ZIP
# You can use {version}, which will be replaced by the `version` entry from your `package.json`
--opera-zip: string
  
# A description of the changes in this version, compared to the previous one
# You can use \n for new lines
--opera-changelog?: string

Example:

web-ext-deploy --opera-package-id=123456 --opera-sessionid="sessionid_value" --opera-csrftoken="csrftoken_value" --opera-zip="dist/some-zip-v{version}.zip" --opera-changelog="Changelog\nWith line breaks"

Notes:

Source code inspection:
The Opera Add-ons reviewers require inspecting your extension's source code.
This can be done by doing one of the following:
- Uploading the ZIP that contains the source code to a public folder on a storage service like Google Drive
- Making the extension's code open source on a platform like GitHub, with clear instructions on the README.md, and then linking to its repository.
Note that you do not want to store the command with your extension package, as the review team will have access to your precious cookies.

Node.js API method

ESM

import { deployChrome, deployFirefoxSubmissionApi, deployEdgePublishApi, deployOpera } from "web-ext-deploy";

Chrome Web Store API

deployChrome object

# Get it from https://chrome.google.com/webstore/detail/EXT_ID, e.g. https://chrome.google.com/webstore/detail/fcphghnknhkimeagdglkljinmpbagone
extId: string;

# Get them by following https://github.com/fregante/chrome-webstore-upload-keys
refreshToken: string;
clientId: string;
clientSecret: string;

# The relative path from the root to the ZIP
# You can use {version} in the ZIP filename, which will be replaced by the `version` entry from your `package.json`
zip: string;

# Setting to `true` will result in every step of the upload process be logged to the console
verbose?: boolean;

Returns Promise<true> or throws an exception.

Firefox Submission API

deployFirefoxSubmissionApi object

# Get it from https://addons.mozilla.org/addon/EXT_ID
extId: string;

# Get them from https://addons.mozilla.org/developers/addon/api/key
jwtIssuer: string;
jwtSecret: string;

# The relative path from the root to the ZIP
# You can use {version} in the ZIP filename, which will be replaced by the `version` entry from your package.json
zip: string;

# If applicable, the relative path from the root to the ZIP source
# You can use {version} in the ZIP filename, which will be replaced by the `version` entry from your `package.json`
zipSource?: string;

# A description of the changes in this version, compared to the previous one
# It's recommended to use instead --firefox-changelog , so it stays up to date
changelog?: string;

# A description of the technical changes made in this version, compared to the previous one
# This will only be seen by the Firefox Addons reviewers
# It's recommended to use instead --firefox-dev-changelog , so it stays up to date
devChangelog?: string;

# Setting to `true` will result in every step of the upload process be logged to the console
verbose?: boolean;

Returns Promise<true> or throws an exception

Edge Publish API

deployEdgePublishApi object

# Get it from https://partner.microsoft.com/en-us/dashboard/microsoftedge/PRODUCT_ID
productId: string;

# Get them by following https://github.com/avi12/web-ext-deploy/blob/main/EDGE_PUBLISH_API.md
clientId: string;
apiKey: string;

# The relative path from the root to the zip
# You can use {version}, which will be replaced by the version in package.json
zip: string;

# The technical changes made in this version, compared to the previous one
devChangelog?: string;

# Setting to `true` will result in every step of the upload process be logged to the console
verbose?: boolean;

Returns Promise<true> or throws an exception

Note:
Due to the way the Edge dashboard works, when an extension is being reviewed or its review has just been canceled, it will take about a minute until a cancellation will cause its state to change from "In review" to "In draft", after which the new version can be submitted
Therefore, expect for longer wait times if you run the tool on an extension you had just published/canceled

Opera API

deployOpera object

# The package ID of the extension from the store dashboard, e.g. https://addons.opera.com/developer/package/PACKAGE_ID
packageId: number;

# If you have a hard time obtaining them, run: web-ext-deploy --get-cookies=opera
sessionid: string;
csrftoken: string;

# The relative path from the root to the ZIP.  
# You can use {version} in the ZIP filename, which will be replaced by the `version` entry from your package.json
zip: string;

# A description of the changes in this version, compared to the previous one.
# It's recommended to use instead --opera-changelog , so it stays up to date.
changelog?: string;

# Setting to `true` will result in every step of the upload process be logged to the console
verbose?: boolean;

Returns Promise<true> or throws an exception.

Notes:

Source code inspection:
The Opera Add-ons reviewers require inspecting your extension's source code
This can be done by doing one of the following:
- Uploading the ZIP that contains the source code to a public folder on a storage service such as Google Drive
- Making the extension's code open source on a platform like GitHub, with clear instructions on the README.md, and then linking to its repository
Note that you do not want to store the deployment script with your extension package, as the review team will have access to your precious cookies
If you'll open-source the extension on GitHub, you can exclude the deployment script by listing it in .gitignore

Examples:

import { deployChrome, deployFirefoxSubmissionApi, deployEdgePublishApi, deployOpera } from "web-ext-deploy";

deployChrome({
  extId: "ExtensionID",
  refreshToken: "refreshToken",
  clientId: "clientId",
  clientSecret: "clientSecret",
  zip: "dist/some-zip-v{version}.zip",
  verbose: false
}).catch(console.error);

deployFirefoxSubmissionApi({
  extId: "EXT_ID",
  jwtIssuer: "jwtIssuer",
  jwtSecret: "jwtSecret",
  zip: "dist/some-zip-v{version}.zip",
  zipSource: "dist/zip-source-v{version}.zip",
  changelog: "Some changes",
  devChangelog: "Changes for reviewers",
  verbose: false
}).catch(console.error);

deployEdgePublishApi({
  productId: "PRODUCT_ID",
  clientId: "clientId",
  apiKey: "apiKey",
  zip: "dist/some-zip-v{version}.zip",
  devChangelog: "Changes for reviewers",
  verbose: false
}).catch(console.error);

deployOpera({
  packageId: 123456,
  sessionid: "sessionid_value",
  csrftoken: "csrftoken_value",
  zip: "dist/some-zip-v{version}.zip",
  changelog: "Some changes",
  verbose: false
}).catch(console.error);

Name		Name	Last commit message	Last commit date
Latest commit History 407 Commits
.github		.github
src		src
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmignore		.npmignore
.prettierrc.json		.prettierrc.json
EDGE_PUBLISH_API.md		EDGE_PUBLISH_API.md
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
nodemon-dev.json		nodemon-dev.json
nodemon.json		nodemon.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

WebExt Deploy

Core packages/APIs used

Installing

Usage

1. Obtain the relevant cookie(s) of the publisher's account:

Disclaimer: I do NOT take any responsibility for leaked cookies or credentials.

2. Decide how to access the data & credentials

`.env` files method

Additional arguments for the `.env` mode:

Notes:

Possible `.env` files

`chrome.env`

`firefox.env`

`edge.env`

`opera.env`

CLI arguments method

CLI API

Chrome Web Store CLI

Firefox Add-ons CLI

Edge Add-ons CLI

Opera Add-ons CLI

Node.js API method

ESM

Node.js API

Chrome Web Store API

Firefox Submission API

Edge Publish API

Opera API

About

Releases 44

Sponsor this project

Contributors 2

Languages

License

avi12/web-ext-deploy

Folders and files

Latest commit

History

Repository files navigation

WebExt Deploy

Core packages/APIs used

Installing

Usage

1. Obtain the relevant cookie(s) of the publisher's account:

Disclaimer: I do NOT take any responsibility for leaked cookies or credentials.

2. Decide how to access the data & credentials

.env files method

Additional arguments for the .env mode:

Notes:

Possible .env files

chrome.env

firefox.env

edge.env

opera.env

CLI arguments method

CLI API

Chrome Web Store CLI

Firefox Add-ons CLI

Edge Add-ons CLI

Opera Add-ons CLI

Node.js API method

ESM

Node.js API

Chrome Web Store API

Firefox Submission API

Edge Publish API

Opera API

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 44

Sponsor this project

Contributors 2

Languages

`.env` files method

Additional arguments for the `.env` mode:

Possible `.env` files

`chrome.env`

`firefox.env`

`edge.env`

`opera.env`