Photos downloads from Apps instead of shipping in Breeze, practice and guide voice clips move to Ogg Opus, dependencies update (Ziran, Kryon, Apps, Arcade, practices), and the 2.1.63 version and store notes are prepared. The Practice tab note is translated in every locale.
Firefox Add-on Source Build
This document is for Mozilla Add-ons reviewers and anyone who needs to rebuild
inbe-firefox-addons.zip from the source tree.
Build Environment
The Firefox add-on build is a WebAssembly web build wrapped with the Firefox extension manifest and background script. It is tested in CI on Ubuntu Linux. FreeBSD can also be used when the same tools are available.
Required tools:
- POSIX shell (
sh) - GNU Make (
makeon Linux, usuallygmakeon FreeBSD) - C/C++ build tools (
cc,ar, standard libc headers) - CMake
- Emscripten SDK with
emcc,emar, andemranlibonPATH - Node.js 22 or newer and npm
zipperl- Tcl (
tclsh) for generating SQLite amalgamation from canonical source
Ubuntu package dependencies used by CI are listed in
.github/apt/web-packages.txt and can be installed with:
sudo apt-get update
sudo apt-get install -y build-essential zlib1g-dev zip tcl
Install Node.js 22 or newer from your system package manager, NodeSource, nvm, or the official Node.js downloads. Verify it with:
node --version
npm --version
Install and activate Emscripten SDK. The CI build uses the latest emsdk release:
git clone --depth 1 https://github.com/emscripten-core/emsdk.git "$HOME/emsdk"
"$HOME/emsdk/emsdk" install latest
"$HOME/emsdk/emsdk" activate latest
. "$HOME/emsdk/emsdk_env.sh"
Verify Emscripten with:
emcc --version
The Mozilla linter is run through npm. The default build uses:
npx --yes addons-linter
You may pin or override it with ADDONS_LINTER, for example:
ADDONS_LINTER="npx --yes addons-linter@latest"
Build Steps
From the repository root, including initialized submodules, run:
sh scripts/build-firefox-addons-source.sh
The script performs all technical build steps:
- Selects one stable
WEB_CACHE_BUSTERvalue for the run. - Prints relevant tool versions.
- Builds packaged runtime assets.
- Builds the Firefox add-on zip.
- Runs Mozilla
addons-linteragainst the zip. - Verifies the final zip exists.
Output:
build/dist/inbe-firefox-addons.zip
For a deterministic cache-buster string, set WEB_CACHE_BUSTER explicitly:
WEB_CACHE_BUSTER=<source-commit-or-version> sh scripts/build-firefox-addons-source.sh
Without WEB_CACHE_BUSTER, the wrapper script uses the current git commit hash
when available, otherwise a timestamp selected once at script startup. The
Makefile itself still supports its normal local fallback behavior.
SQLite Amalgamation
SQLite is pinned in ziran.lock as the official canonical source repository and
fetched to build/packages/sqlite.
The build generates vendor-builds/sqlite/sqlite3.c and sqlite3.h from that
source with SQLite's recommended amalgamation flow (configure, then
make sqlite3.c sqlite3.h). This keeps the Firefox source submission rooted in
the official SQLite source instead of depending on a checked-in generated
vendor-builds artifact.
Firefox Packaging Notes
The normal web build injects a small inline bootstrap script. Firefox extension
CSP blocks inline JavaScript, so the Firefox package rule renders the same web
shell template with an external extension_loader.js script tag. The loader
source is kept in this directory and is copied into the generated add-on package.