Translmate

LLM-powered Firefox translation extension built with WXT and Svelte.

AMO reviewer build instructions

The submitted source archive contains the original TypeScript and Svelte sources. WXT and Vite bundle those sources into the JavaScript files contained in the submitted Firefox extension archive.

Build environment

• Linux x86_64 (the clean reproducibility build environment)
• Node.js 24.14.0 or later
• pnpm 10.28.1
• The generated extension contains no architecture-specific native runtime binaries.
• No credentials or environment variables are required to build the extension.
• Dependencies are installed from the public npm registry and pinned by pnpm-lock.yaml.

Install the required package manager:

npm install --global pnpm@10.28.1

From the directory containing this README, install dependencies and create the Firefox archive:

pnpm install --frozen-lockfile
pnpm exec wxt zip -b firefox

The resulting extension is:

.output/translmate-0.0.4-firefox.zip

ZIP metadata such as timestamps may differ. The extracted extension contents must match the submitted Firefox archive.

Optional verification:

pnpm test
pnpm compile

The network-backed live tests are disabled by default and are not required for the build.

Architecture

• Page-agent runtime: docs/page-agent-architecture.md
• Planned document/chat/compaction refactor: docs/superpowers/plans/2026-06-10-page-agent-document-chat-compaction.md
• AMO reviewer notes: docs/amo-reviewer-notes.md

Verification

pnpm test
pnpm compile
pnpm build:firefox