wepub

A CLI to publish browser extensions to web stores.

Firefox (AMO) and Chrome Web Store are supported; Edge Add-ons is planned.

Install

cargo install wepub

Requires Rust 1.85+ (edition 2024).

Usage

Firefox (AMO)

Get a JWT credential pair from https://addons.mozilla.org/developers/addon/api/key/, then:

wepub firefox ./my-addon.zip \
  --addon-id   "myaddon@example.com" \
  --api-key    "user:1234567:89" \
  --api-secret "abcdef..." \
  --channel    listed

Credentials can also be supplied via environment variables:

Flag	Environment variable
`--addon-id`	`WEPUB_FIREFOX_ADDON_ID`
`--api-key`	`WEPUB_FIREFOX_API_KEY`
`--api-secret`	`WEPUB_FIREFOX_API_SECRET`
`--amo-base-url`	`WEPUB_FIREFOX_AMO_BASE_URL`

Run wepub firefox --help for the full list of flags (compatibility, release notes, approval notes, source archive, etc.).

Only existing add-ons can be updated. The very first version of an add-on must still be uploaded through the AMO web UI.

Chrome Web Store

Follow the Chrome Web Store API setup guide to obtain an OAuth client ID, client secret and refresh token, then:

wepub chrome ./my-extension.zip \
  --publisher-id   "12345678-90ab-cdef-1234-567890abcdef" \
  --item-id        "abcdefghijklmnopabcdefghijklmnop" \
  --client-id      "...apps.googleusercontent.com" \
  --client-secret  "..." \
  --refresh-token  "1//0..."

Alternatively, supply a pre-fetched OAuth access token (e.g. from gcloud auth print-access-token or a Workload Identity Federation flow) via --access-token. The two authentication modes are mutually exclusive.

Credentials and IDs can also be supplied via environment variables:

Flag	Environment variable
`--publisher-id`	`WEPUB_CHROME_PUBLISHER_ID`
`--item-id`	`WEPUB_CHROME_ITEM_ID`
`--client-id`	`WEPUB_CHROME_CLIENT_ID`
`--client-secret`	`WEPUB_CHROME_CLIENT_SECRET`
`--refresh-token`	`WEPUB_CHROME_REFRESH_TOKEN`
`--access-token`	`WEPUB_CHROME_ACCESS_TOKEN`
`--cws-root-url`	`WEPUB_CHROME_CWS_ROOT_URL`
`--cws-token-url`	`WEPUB_CHROME_CWS_TOKEN_URL`

Run wepub chrome --help for the full list of flags (publish type, deploy percentage, skip review, etc.).

Only existing items can be updated. New items must still be created through the Chrome Web Store Developer Dashboard.

`.env` file

wepub reads a .env file from the current working directory at startup. Any KEY=VALUE lines populate the process environment for subsequent flag resolution, so the WEPUB_* variables documented above can live in .env alongside your project. Existing shell environment values take precedence over .env entries.

Logging

Default: INFO level (upload / validation progress visible)
-v / --verbose: DEBUG
-q / --quiet: WARN+ only
RUST_LOG: takes precedence (e.g. RUST_LOG=trace)

Development

This is a Cargo workspace with two crates:

crates/wepub-core — async library that talks to store APIs (built on reqwest + tokio)
crates/wepub — CLI binary (#[tokio::main], clap)

cargo build --workspace
cargo test  --workspace
cargo clippy --workspace --all-targets -- -D warnings

Pre-commit hooks (prek) run cargo fmt --check and cargo clippy on Rust file changes.

License

Licensed under either of MIT or Apache-2.0, at your option.

wepub-core 0.1.0