diff --git a/.github/workflows/test-i18n.yml b/.github/workflows/test-i18n.yml
new file mode 100644
index 00000000..5786b4fa
--- /dev/null
+++ b/.github/workflows/test-i18n.yml
@@ -0,0 +1,32 @@
+name: i18n tests
+
+on:
+ pull_request:
+ push:
+ branches: [main]
+ paths:
+ - 'shared/i18n*.js'
+ - 'shared/locales/**'
+ - 'shared/test/**'
+ - 'windows/**'
+ - 'linux/**'
+ - 'mac/**'
+ - 'android/app/src/main/res/**'
+ - 'website/locales/**'
+
+jobs:
+ i18n:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ - run: node shared/test/i18n.js
+ - run: node shared/test/i18n-coverage.js
+ - run: node shared/test/i18n-glossary.js
+ - run: node shared/test/i18n-scope.js
+ - run: node shared/test/ui-load.js
+ - run: node shared/test/packaging.js
+ - run: node shared/test/sidebar-model.js
+ - run: node shared/test/traymenu.js
diff --git a/docs/i18n-coverage.md b/docs/i18n-coverage.md
new file mode 100644
index 00000000..62787a51
--- /dev/null
+++ b/docs/i18n-coverage.md
@@ -0,0 +1,15 @@
+# Cobertura de tradução (gerado por `node shared/test/i18n-coverage.js --write`)
+
+Literais de interface em inglês fora de `t()`, por superfície. Heurística: ver o cabeçalho do teste.
+
+| Superfície | Arquivos | Chamadas `t()` | Literais em inglês | % pendente |
+|---|---|---|---|---|
+| Páginas do desktop | 57 | 2295 | 0 | 0.0% |
+| Mesh | 16 | 913 | 0 | 0.0% |
+| Módulos shared/ui | 19 | 907 | 0 | 0.0% |
+| Processo principal | 183 | 636 | 0 | 0.0% |
+| Efeitos e módulos shared | 18 | 513 | 0 | 0.0% |
+| Janelas pequenas | 32 | 53 | 0 | 0.0% |
+
+## Pendentes
+
diff --git a/docs/i18n-glossary.md b/docs/i18n-glossary.md
new file mode 100644
index 00000000..99a536b5
--- /dev/null
+++ b/docs/i18n-glossary.md
@@ -0,0 +1,22 @@
+# Glossário pt-BR do DuoDesk
+
+Termos fixos da interface em português do Brasil. O teste `shared/test/i18n-glossary.js` falha se um termo
+proibido aparecer em `shared/locales/pt-BR.js`, em `android/.../values-pt-rBR/strings.xml` ou em
+`website/locales/pt-BR.json`. Tratamento: sempre "você".
+
+| Inglês | Use | Não use |
+|---|---|---|
+| pair, pairing, paired | parear, pareamento, pareado | emparelhar, emparelhamento |
+| app (aplicativo) | aplicativo | app, apps |
+| on / off (estado de um recurso) | ativado, desativado, ativar, desativar | ligado, desligado, ligar, desligar |
+| phone | telefone | celular, smartphone |
+| clipboard | área de transferência | clipboard |
+| debugging | depuração | debug |
+| hotspot | ponto de acesso | hotspot |
+| wireless | sem fio | wireless |
+| you, your | você, seu/sua | tu, teu/tua |
+
+Exceções: nomes próprios e de produtos (Wi-Fi Direct, Bluetooth, Android, GitHub), a palavra "Ligar" só como
+verbo de chamada telefônica, e "desligar o computador" (energia).
+Regras de estilo: frase em "sentence case" nos textos corridos; "Title Case" só onde o inglês também usa;
+sem gênero preso ao nome do dispositivo (`{phone}`, `{name}`): reescrever na forma neutra.
diff --git a/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md b/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md
new file mode 100644
index 00000000..de6fe54b
--- /dev/null
+++ b/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md
@@ -0,0 +1,126 @@
+# DuoDesk i18n pt-BR: plano de implantação
+
+Data: 2026-10-31. Complementa `2026-10-31-duodesk-i18n-pt-br.md` (arquitetura). Este plano cobre o que falta
+para publicar o pt-BR e como colocá-lo no ar sem regressão no inglês.
+
+## 1. Estado atual
+
+Commits locais à frente de `origin/main`: 12 (motor, dicionários, desktop, Android, site, docs, correções).
+Nada foi enviado ao remoto.
+
+Pronto:
+- Motor `shared/i18n.js`, dicionários `en`/`pt-BR` (~1.190 chaves, paridade de `{param}` testada).
+- Desktop (Windows, Linux, macOS): navegação, cabeçalhos e descrições das abas, todas as páginas principais,
+ bandeja/barra de menus, seletor de idioma em Geral, persistência em `settings.app.lang`.
+- Shells mesh: carregam o i18n e traduzem a navegação e os cabeçalhos.
+- Android: ~550 strings em `values` e `values-pt-rBR`, 5 plurais.
+- Site: troca EN/PT, `404.js` e `lang-boot.js` compatíveis com a CSP.
+- README e docs em pt-BR.
+
+Pendente (desktop, em inglês):
+1. `mesh/ui-*.js` (Windows 5 arquivos, Linux 4, macOS 5).
+2. `shared/ui-*.js`, `pairpop.js`, `aurora-shell.js` (hub, chamadas, mensagens, mídia, arquivos do telefone,
+ dispositivo, espelho, câmera, suporte, janela de atualização, QR/ADB).
+3. Janelas pequenas: HUD, appview, phoneview, sender, sound, monitor, appsend, audio, capture, pcview
+ (usar `shared/i18n-dom.js`, já criado).
+4. Processo principal: notificações, diálogos, HUD, mensagens de erro/status em `windows/*.js`, `linux/*.js`,
+ `mac/*.js` e `shared/*.js` de Node.
+5. Android: `Hub.label`, `Files.plural`, `FolderShare.shown()`, rótulos do `AndroidManifest.xml`.
+
+## 2. Fase A: concluir o desktop
+
+Método (o mesmo que funcionou na rodada anterior):
+- Um lote por grupo de arquivos, sem arquivos em comum entre lotes. Cada lote envolve o texto em
+ `t(chave, params, inglês_exato)` e grava só as chaves novas em um fragmento JSON; ninguém edita
+ `shared/locales/*.js` durante o lote.
+- Convenção de chave: `
.`; prefixos `mesh_`, `meshm_`, `win_`, `lin_`, `mac_`, `sh_` por grupo.
+- Regras: inglês idêntico ao original; `{me}`, `{name}`, `{Name}`, `{the}`, `{There}` ficam no texto
+ (o `UI.fill` os preenche); sem concatenação de fragmentos; plural em `_one`/`_other`; não traduzir logs,
+ texto comparado no código, mensagens enviadas ao outro dispositivo, nomes de marca.
+- Ordem sugerida (menor risco primeiro): janelas pequenas, `shared/ui-*`, mesh, processo principal.
+ O processo principal é o mais arriscado: grep do texto antes de embrulhar, para não quebrar comparações.
+
+Mesclar fragmentos (script de mescla):
+- Chave igual com inglês diferente entre plataformas vira variante `_linux`/`_mac` e o código dessa
+ plataforma é renomeado.
+- Chave igual com pt diferente: prevalece a do Windows; revisar a lista de divergências.
+- Regravar os dicionários, rodar a validação (seção 4).
+
+Critério de pronto da fase: nenhum literal de interface em inglês fora das exceções documentadas
+(marcas, unidades, texto vindo do telefone ou do outro computador).
+
+## 3. Fase B: Android
+
+1. Instalar JDK 17+ e o Android SDK (a máquina atual não tem); `cd android && ./gradlew :app:assembleDebug`.
+2. Corrigir o que o compilador acusar (principal risco: `stringResource` fora de contexto composable,
+ `pluralStringResource` sem opt-in).
+3. Traduzir `Hub.label`, `Files.plural`, `FolderShare.shown()` e os rótulos do manifest
+ (`strings.xml` com `@string/...`).
+4. Teste em aparelho/emulador com idioma do sistema em Português (Brasil) e em English: percorrer
+ Visão Geral, Conexão, Chamadas, Mensagens, Arquivos, Mouse, Ajustes, diálogos de pareamento,
+ notificações; procurar texto cortado e quebras de linha.
+
+## 4. Verificação (portões antes de qualquer merge)
+
+Automáticos (todos devem passar; `applog`, `kvm-moves`, `movebench` já falham em `origin/main`):
+```bash
+for t in shared/test/*.js; do node "$t" >/dev/null 2>&1 || echo "FAIL $t"; done
+node shared/test/i18n.js # paridade, chaves usadas existem
+node shared/test/packaging.js # locales e i18n entram nos instaladores
+```
+Acrescentar ao repositório (hoje só existem como scripts soltos):
+- Verificação de padrão em inglês: todo `t('chave', p, 'inglês')` literal deve igualar o valor em `en.js`
+ (pegou a regressão de `sidebar.nearby` e da navegação).
+- Verificação de chaves órfãs.
+- Verificação de parâmetros: toda chave com `{x}` recebe `x` no ponto de chamada (exceto os tokens do `UI.fill`).
+
+Manual, por plataforma (Windows, macOS, Linux X11/Wayland), com `lang` em `auto`, `en` e `pt-BR`:
+- Trocar o idioma em Geral: recarrega, nav, cabeçalhos, descrições e bandeja mudam.
+- Cada aba abre sem erro no console; conferir texto cortado em 1366×768, 1440×900 e 375×812 (mesh/janela estreita).
+- Pareamento completo com outro computador e com o telefone: banner, códigos, estados.
+- Bandeja: conectado e desconectado, "Conectar a", "Procurar novamente".
+- Migração: perfil que tinha o idioma só no `localStorage` passa a ter `settings.app.lang`.
+- Inglês idêntico ao de `origin/main` (comparar capturas de 3 páginas por plataforma).
+
+Site: `node website/dev-server.js`; EN e PT, `/404`, recarga com PT salvo (sem flash), CSP sem erro no console
+(sem script inline).
+
+## 5. Fase C: integração e publicação
+
+1. Rebase/merge de `main` na branch de trabalho; resolver conflitos (as páginas `ui-*.js` mudam muito).
+2. Abrir PR por área para facilitar a revisão: (a) motor + dicionários + testes; (b) desktop; (c) Android;
+ (d) site + docs. Cada PR passa pelos portões da seção 4.
+3. Antes do `push`: confirmar com o dono do repositório (o remoto é `0xCodez/DuoDesk`; se não houver
+ permissão de push, enviar para um fork e abrir PR do fork).
+4. Versão: subir a versão do app (changelog: "Português (Brasil)"), atualizar o `README.md` e `README.pt-BR.md`
+ (número da versão, links de download) e as notas da release.
+5. CI/instaladores: gerar `.exe`, `.dmg`, `.deb`/AppImage, Nix e APK; instalar cada artefato em máquina limpa e
+ confirmar que `shared/locales/` existe no pacote e o idioma troca.
+6. Site: deploy na Vercel (preview primeiro); conferir `vercel.json` (CSP com `404.js` e `lang-boot.js`).
+7. Anúncio: release no GitHub com as notas em EN e PT.
+
+## 6. Riscos e reversão
+
+| Risco | Mitigação |
+|---|---|
+| Regressão no inglês (texto padrão diferente do dicionário) | portão de padrão em inglês na seção 4 |
+| Texto comparado no código quebra ao traduzir (processo principal) | grep antes de embrulhar; testes de `shared/test` |
+| Idioma só definido depois do carregamento (constantes no topo do módulo) | traduzir no uso/renderização, nunca na carga |
+| Janela que não carrega `i18n.js` mostra chave | padrão em inglês no `t()` local cobre; checar no manual |
+| Android não compila | Fase B antes de qualquer PR do Android |
+| Instalador sem `locales/` | `packaging.js` + instalação em máquina limpa |
+
+Reversão: cada área vai em PR próprio e o idioma cai para inglês sozinho se o dicionário `pt-BR` falhar
+(`t()` usa `en`). Para desligar o pt-BR sem reverter código: remover a opção `pt-BR` do seletor em Geral
+e do `getAvailableLanguages`, e forçar `en` em `applyLanguage`.
+
+## 7. Ordem e estimativa
+
+1. Fase A, janelas pequenas e `shared/ui-*` (lotes paralelos), mescla, validação.
+2. Fase A, mesh e processo principal, mescla, validação.
+3. Fase B (depende de JDK/SDK).
+4. Verificação manual nas 3 plataformas + site.
+5. PRs e publicação (Fase C).
+
+As fases A e B são independentes e podem andar em paralelo. A verificação manual é o gargalo:
+precisa de uma máquina de cada sistema.
diff --git a/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md b/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md
new file mode 100644
index 00000000..71837f6e
--- /dev/null
+++ b/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md
@@ -0,0 +1,434 @@
+# DuoDesk i18n & Tradução para Português (Brasil) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Implementar arquitetura de internacionalização (i18n) completa e traduzir 100% do DuoDesk para Português do Brasil (pt-BR) abrangendo Desktop (Windows/macOS/Linux), Documentação, Android e Website.
+
+**Architecture:** Módulo core `shared/i18n.js` isomórfico (Node + Browser) zero-dependency com dicionários `shared/locales/en.js` e `shared/locales/pt-BR.js`. Integração em renderers Electron via script tags e persistência via store local. No Android, extração para `values-pt-rBR/strings.xml` com integração Jetpack Compose. Na documentação, `README.pt-BR.md` completo com seletor de idiomas.
+
+**Tech Stack:** JavaScript (ES6 vanilla, Node.js assert), HTML5/CSS3, Electron, Android Kotlin (Jetpack Compose, XML resources), Markdown.
+
+**Spec:** [duodesk-i18n-spec.md](file:///C:/Users/Mau/.gemini/antigravity/brain/2ead9a51-f63f-4695-b736-2f0c7af12ec9/duodesk-i18n-spec.md)
+
+## Global Constraints
+
+- Zero dependências npm externas adicionadas aos pacotes de runtime do Electron.
+- Compatibilidade estrita com Content-Security-Policy (`script-src 'self'`).
+- Carregamento síncrono das traduções evitando Cumulative Layout Shift (CLS) e flashes de conteúdo sem tradução (FOUT).
+- Fallback automático para `en` quando uma chave não existir no idioma selecionado.
+- Preservar integridade de código, testes existentes e compatibilidade com macOS, Windows e Linux.
+
+## Review Focus
+
+1. Interpolação de variáveis ausentes ou nulas em `t(key, params)` não deve lançar erro nem quebrar a UI, retornando a string original ou o placeholder intacto.
+2. Troca de idioma em runtime em Configurações Gerais deve atualizar imediatamente os textos visíveis sem exigir reinicialização manual do app.
+3. Chave inexistente deve retornar a chave original ou o `defaultText` em vez de `undefined`.
+4. Detecção de idioma do sistema (`navigator.language`) deve mapear variantes como `pt`, `pt-BR`, `pt_BR` para o catálogo `pt-BR`.
+5. Recursos Android não devem falhar em tempo de compilação ou execução caso o dispositivo utilize um locale não traduzido (fallback para `values/strings.xml`).
+
+---
+
+### Task 1: Core i18n Engine & Catálogos de Idioma (Desktop & Shared)
+
+**Files:**
+- Create: `shared/locales/en.js`
+- Create: `shared/locales/pt-BR.js`
+- Create: `shared/i18n.js`
+- Test: `shared/test/i18n.js`
+
+**Interfaces:**
+- Produces:
+ - `i18n.t(key: string, params?: object, defaultText?: string): string`
+ - `i18n.setLanguage(lang: string): string`
+ - `i18n.getLanguage(): string`
+ - `i18n.getAvailableLanguages(): Array<{code: string, label: string}>`
+ - `i18n.onLanguageChange(listener: (lang: string) => void): () => void`
+
+- [ ] **Step 1: Escrever teste de unidade que falha para o motor i18n**
+
+Criar `shared/test/i18n.js`:
+```javascript
+'use strict';
+const assert = require('assert');
+const i18n = require('../i18n.js');
+
+// Teste 1: Chave básica em inglês padrão
+i18n.setLanguage('en');
+assert.strictEqual(i18n.t('app.name'), 'DuoDesk');
+
+// Teste 2: Alternância para pt-BR
+i18n.setLanguage('pt-BR');
+assert.strictEqual(i18n.t('nav.overview'), 'Visão Geral');
+
+// Teste 3: Interpolação de parâmetros
+assert.strictEqual(
+ i18n.t('pair.hint_code', { code: '1234' }),
+ 'Digite o código 1234 no outro computador'
+);
+
+// Teste 4: Fallback para chave inexistente
+assert.strictEqual(i18n.t('non.existent.key', null, 'Texto Fallback'), 'Texto Fallback');
+
+// Teste 5: Listener de mudança de idioma
+let changedTo = null;
+const unsubscribe = i18n.onLanguageChange((lang) => { changedTo = lang; });
+i18n.setLanguage('en');
+assert.strictEqual(changedTo, 'en');
+unsubscribe();
+
+console.log('i18n: ok');
+```
+
+- [ ] **Step 2: Executar teste para verificar falha inicial**
+
+Comando: `node shared/test/i18n.js`
+Esperado: FAIL com `Cannot find module '../i18n.js'`
+
+- [ ] **Step 3: Implementar catálogos e motor core `shared/i18n.js`**
+
+Criar `shared/locales/en.js`:
+```javascript
+(function (root, factory) {
+ if (typeof module === 'object' && module.exports) module.exports = factory();
+ else {
+ root.DuoDeskLocales = root.DuoDeskLocales || {};
+ root.DuoDeskLocales['en'] = factory();
+ }
+})(typeof globalThis !== 'undefined' ? globalThis : this, function () {
+ return {
+ 'app.name': 'DuoDesk',
+ 'app.not_paired': 'Not paired',
+ 'app.paired_with': 'Paired with {name}',
+ 'nav.overview': 'Overview',
+ 'nav.screens': 'Screens',
+ 'nav.cursor': 'Mouse & Keys',
+ 'nav.audio': 'Audio',
+ 'nav.files': 'Files',
+ 'nav.apps': 'Apps',
+ 'nav.phone': 'Phone',
+ 'nav.settings': 'General',
+ 'nav.about': 'About',
+ 'pair.title': 'Pairing',
+ 'pair.code_label': 'Code',
+ 'pair.match': 'Codes match',
+ 'pair.cancel': 'Cancel',
+ 'pair.hint_code': 'Type the code {code} on the other computer',
+ 'general.language': 'Language',
+ 'general.lang_auto': 'Automatic (System)',
+ 'general.lang_en': 'English',
+ 'general.lang_pt_br': 'Português (Brasil)'
+ };
+});
+```
+
+Criar `shared/locales/pt-BR.js`:
+```javascript
+(function (root, factory) {
+ if (typeof module === 'object' && module.exports) module.exports = factory();
+ else {
+ root.DuoDeskLocales = root.DuoDeskLocales || {};
+ root.DuoDeskLocales['pt-BR'] = factory();
+ }
+})(typeof globalThis !== 'undefined' ? globalThis : this, function () {
+ return {
+ 'app.name': 'DuoDesk',
+ 'app.not_paired': 'Não pareado',
+ 'app.paired_with': 'Pareado com {name}',
+ 'nav.overview': 'Visão Geral',
+ 'nav.screens': 'Telas',
+ 'nav.cursor': 'Mouse e Teclado',
+ 'nav.audio': 'Áudio',
+ 'nav.files': 'Arquivos',
+ 'nav.apps': 'Aplicativos',
+ 'nav.phone': 'Telefone',
+ 'nav.settings': 'Geral',
+ 'nav.about': 'Sobre',
+ 'pair.title': 'Pareamento',
+ 'pair.code_label': 'Código',
+ 'pair.match': 'Códigos coincidem',
+ 'pair.cancel': 'Cancelar',
+ 'pair.hint_code': 'Digite o código {code} no outro computador',
+ 'general.language': 'Idioma',
+ 'general.lang_auto': 'Automático (Sistema)',
+ 'general.lang_en': 'English',
+ 'general.lang_pt_br': 'Português (Brasil)'
+ };
+});
+```
+
+Criar `shared/i18n.js`:
+```javascript
+(function (root, factory) {
+ if (typeof module === 'object' && module.exports) {
+ const en = require('./locales/en.js');
+ const ptBR = require('./locales/pt-BR.js');
+ module.exports = factory({ 'en': en, 'pt-BR': ptBR });
+ } else {
+ root.DuoDeskI18n = factory(root.DuoDeskLocales || {});
+ root.t = root.DuoDeskI18n.t;
+ }
+})(typeof globalThis !== 'undefined' ? globalThis : this, function (locales) {
+ 'use strict';
+ let currentLang = 'en';
+ const listeners = new Set();
+
+ function normalizeLang(lang) {
+ if (!lang) return 'en';
+ const lower = String(lang).toLowerCase();
+ if (lower.startsWith('pt')) return 'pt-BR';
+ if (lower.startsWith('en')) return 'en';
+ return locales[lang] ? lang : 'en';
+ }
+
+ function t(key, params, defaultText) {
+ const dict = locales[currentLang] || locales['en'] || {};
+ const fallbackDict = locales['en'] || {};
+ let text = dict[key] !== undefined ? dict[key] : (fallbackDict[key] !== undefined ? fallbackDict[key] : (defaultText !== undefined ? defaultText : key));
+ if (params && typeof params === 'object') {
+ text = String(text).replace(/\{(\w+)\}/g, (_, k) => (params[k] !== undefined && params[k] !== null ? params[k] : `{${k}}`));
+ }
+ return text;
+ }
+
+ function setLanguage(lang) {
+ currentLang = normalizeLang(lang);
+ listeners.forEach(fn => { try { fn(currentLang); } catch (e) { console.error(e); } });
+ return currentLang;
+ }
+
+ function getLanguage() { return currentLang; }
+
+ function getAvailableLanguages() {
+ return [
+ { code: 'en', label: 'English' },
+ { code: 'pt-BR', label: 'Português (Brasil)' }
+ ];
+ }
+
+ function onLanguageChange(fn) {
+ listeners.add(fn);
+ return () => listeners.delete(fn);
+ }
+
+ return { t, setLanguage, getLanguage, normalizeLang, getAvailableLanguages, onLanguageChange };
+});
+```
+
+- [ ] **Step 4: Executar teste para verificar sucesso**
+
+Comando: `node shared/test/i18n.js`
+Esperado: `i18n: ok` com exit code 0.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add shared/locales/ shared/i18n.js shared/test/i18n.js
+git commit -m "feat(i18n): add zero-dependency i18n core engine and pt-BR locale"
+```
+
+---
+
+### Task 2: Integração Desktop & Seletor de Idioma em Configurações
+
+**Files:**
+- Modify: `windows/app.html:52-56`
+- Modify: `windows/ui-general.js`
+- Modify: `shared/sidebar-model.js`
+- Modify: `windows/main.js` (ou detecção via preload)
+- Test: Carregar `windows/app.html` via Electron ou validação de script tags.
+
+**Interfaces:**
+- Consumes: `DuoDeskI18n.setLanguage`, `DuoDeskI18n.t`, `DuoDeskI18n.onLanguageChange`
+- Produces: Seleção persistente em `store.set('general.language', value)` e re-render dos rótulos de navegação e status.
+
+- [ ] **Step 1: Adicionar scripts de i18n em `windows/app.html`**
+
+Inserir as tags de script antes dos demais módulos de interface:
+```html
+
+
+
+```
+
+- [ ] **Step 2: Atualizar `shared/sidebar-model.js` para usar chaves de i18n dinâmicas**
+
+Garantir que a renderização dos títulos dos menus passe por `t('nav.' + pageId)`.
+
+- [ ] **Step 3: Adicionar campo seletor de idioma em `windows/ui-general.js`**
+
+Implementar card "Idioma / Language" na tela Geral:
+```javascript
+const langRow = renderSelect({
+ label: t('general.language'),
+ value: store.get('general.language') || 'auto',
+ options: [
+ { value: 'auto', label: t('general.lang_auto') },
+ { value: 'pt-BR', label: 'Português (Brasil)' },
+ { value: 'en', label: 'English' }
+ ],
+ onChange: (val) => {
+ store.set('general.language', val);
+ const target = val === 'auto' ? navigator.language : val;
+ DuoDeskI18n.setLanguage(target);
+ location.reload();
+ }
+});
+```
+
+- [ ] **Step 4: Validar sintaxe e integridade dos arquivos modificados**
+
+Comando: `node -c windows/ui-general.js shared/sidebar-model.js`
+Esperado: Exit code 0 sem erros de sintaxe.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add windows/app.html windows/ui-general.js shared/sidebar-model.js
+git commit -m "feat(ui): integrate i18n into desktop shell and general settings"
+```
+
+---
+
+### Task 3: Tradução Completa dos Dicionários e Sub-sistemas Desktop
+
+**Files:**
+- Modify: `shared/locales/en.js`
+- Modify: `shared/locales/pt-BR.js`
+- Modify: `windows/ui-overview.js`
+- Modify: `windows/ui-cursor.js`
+- Modify: `windows/ui-clipboard.js`
+- Modify: `windows/ui-files.js`
+- Modify: `shared/phonehub.js`
+
+**Interfaces:**
+- Consumes: `t()` em todas as mensagens de status, cards e ações do usuário.
+
+- [ ] **Step 1: Expandir catálogo `shared/locales/pt-BR.js` e `en.js` com todos os termos dos módulos**
+
+Mapear termos de:
+- Pareamento e KVM (Bordas, ativação suave, troca de comando).
+- Compartilhamento de arquivos (arrastar e soltar, downloads recebidos).
+- Telefone (chamadas, mensagens, câmera remota, espelhamento).
+- Áudio e tela secundária.
+
+- [ ] **Step 2: Substituir strings hardcoded por chamadas `t()` nos componentes de tela**
+
+Atualizar `ui-overview.js`, `ui-cursor.js`, `ui-clipboard.js`, `ui-files.js` e `phonehub.js` usando `t(key, params, defaultEnglish)`.
+
+- [ ] **Step 3: Testar consistência dos catálogos**
+
+Adicionar em `shared/test/i18n.js` verificação de paridade de chaves:
+```javascript
+const enKeys = Object.keys(require('../locales/en.js')());
+const ptKeys = Object.keys(require('../locales/pt-BR.js')());
+assert.deepStrictEqual(enKeys.sort(), ptKeys.sort(), 'Chaves en e pt-BR devem ser idênticas');
+```
+
+- [ ] **Step 4: Executar teste de paridade de chaves**
+
+Comando: `node shared/test/i18n.js`
+Esperado: `i18n: ok`
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add shared/locales/ windows/ui-*.js shared/phonehub.js shared/test/i18n.js
+git commit -m "feat(i18n): expand full pt-BR translation across desktop components"
+```
+
+---
+
+### Task 4: Tradução da Documentação (`README.pt-BR.md` e `docs/`)
+
+**Files:**
+- Create: `README.pt-BR.md`
+- Modify: `README.md:1-20`
+- Create: `docs/mesh.pt-BR.md`
+- Create: `docs/screen-mesh.pt-BR.md`
+
+- [ ] **Step 1: Criar o `README.pt-BR.md` completo e localizado**
+
+Traduzir todas as seções:
+- Apresentação: "Todos os seus computadores e seu telefone funcionando em uma única mesa."
+- Recursos: Computadores, Telefones e tablets, Conexões, Primeiros passos.
+- Instruções de compilação e execução para Windows, macOS, Linux, NixOS e Android.
+
+- [ ] **Step 2: Adicionar banner de alternância de idioma no topo do `README.md` original**
+
+Inserir no topo de `README.md`:
+```markdown
+
+```
+
+- [ ] **Step 3: Traduzir guias de arquitetura em `docs/*.pt-BR.md`**
+
+Traduzir `docs/mesh.md` e `docs/screen-mesh.md` mantendo precisão técnica e formatação.
+
+- [ ] **Step 4: Validar links e referências entre os arquivos Markdown**
+
+Verificar existência de links relativos e integridade de imagens.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add README.pt-BR.md README.md docs/*.pt-BR.md
+git commit -m "docs: add full Portuguese (Brazil) translation for README and docs"
+```
+
+---
+
+### Task 5: Localização do Aplicativo Android (Kotlin / Jetpack Compose)
+
+**Files:**
+- Modify: `android/app/src/main/res/values/strings.xml`
+- Create: `android/app/src/main/res/values-pt-rBR/strings.xml`
+- Modify: `android/app/src/main/java/com/twindesk/android/MainActivity.kt`
+
+- [ ] **Step 1: Definir recursos em `values/strings.xml` e `values-pt-rBR/strings.xml`**
+
+Criar `values-pt-rBR/strings.xml` com traduções completas:
+```xml
+
+
+ DuoDesk
+ Depuração sem fio
+ Ativar depuração sem fio
+ Tela do computador
+ Exibir a tela do computador
+ DuoDesk: mouse e teclado do computador
+ Permite que o computador pareado no DuoDesk toque, role e digite neste celular com mouse e teclado quando a depuração sem fio não estiver disponível.
+
+```
+
+- [ ] **Step 2: Mapear textos do Jetpack Compose para recursos traduzíveis**
+
+Ajustar `MainActivity.kt` para garantir que o app reflita automaticamente o idioma do sistema operacional do smartphone.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add android/app/src/main/res/ android/app/src/main/java/
+git commit -m "feat(android): add pt-BR string resources and localization"
+```
+
+---
+
+### Task 6: Localização do Website (`website/`)
+
+**Files:**
+- Modify: `website/index.html`
+- Create: `website/locales/pt-BR.json` (ou script de tradução dinâmica)
+- Modify: `website/app.js`
+
+- [ ] **Step 1: Adicionar suporte a pt-BR no website**
+
+Configurar alternância de idioma no cabeçalho do site com armazenamento em `localStorage`.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add website/
+git commit -m "feat(website): add Portuguese (Brazil) support to DuoDesk website"
+```
diff --git a/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md b/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md
new file mode 100644
index 00000000..d3e7ba7f
--- /dev/null
+++ b/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md
@@ -0,0 +1,139 @@
+# DuoDesk i18n pt-BR: plano para chegar a 9,5
+
+Data: 2026-11-01. Parte da análise de hoje (nota 8,3) e do plano de publicação
+`2026-10-31-duodesk-i18n-implantacao.md`. Este plano diz o que mudar, em que ordem, e como medir cada ganho.
+
+## 1. Meta e como a nota é calculada
+
+Média simples de quatro dimensões. Para 9,5 de média, nenhuma dimensão fica abaixo de 9,0.
+
+| Dimensão | Hoje | Meta | O que falta |
+|---|---|---|---|
+| Qualidade do português | 8,5 | 9,5 | vocabulário padronizado, revisão de frases longas |
+| Cobertura | 7,8 | 9,5 | mesh, janelas pequenas, processo principal, assistente |
+| Robustez técnica | 9,0 | 9,5 | portões de CI, cobertura medida, verificação em app rodando |
+| Site, README, docs | 9,5 | 9,5 | manter |
+
+Cobertura 9,5 significa: menos de 1% de literais em inglês nas superfícies que o usuário vê, fora das exceções
+documentadas (marcas, unidades, texto que vem do telefone ou do outro computador).
+
+## 2. Fase 1: medir (meio dia)
+
+Sem medição, a nota é opinião. Antes de traduzir mais, transformar os scripts soltos em portões do repositório.
+
+1. `shared/test/i18n-coverage.js`: varre os arquivos de interface e do processo principal e conta literais de
+ interface em inglês fora de `t()`. Gera `docs/i18n-coverage.md` (tabela por superfície).
+ Lista de exceções em `shared/test/i18n-allow.json` (marcas, unidades, campos de definição de aba).
+ Falha se a contagem passar do limite gravado. O limite desce a cada fase (nunca sobe).
+2. `shared/test/i18n-defaults.js`: todo `t('chave', p, 'inglês')` literal tem o mesmo texto de `en.js`.
+3. `shared/test/i18n-orphans.js`: nenhuma chave sem uso (exceto `nav.*`, `tab.*`, `tray.*` montadas em tempo de execução).
+4. `shared/test/i18n-params.js`: cada `{x}` do dicionário recebe `x` no ponto de chamada (exceto os tokens do
+ `UI.fill`: `me`, `name`, `Name`, `the`, `There`, `them`).
+5. `shared/test/i18n-glossary.js`: lê `docs/i18n-glossary.md` (seção 3) e falha se o `pt-BR.js` usar um termo
+ proibido (ex.: "emparelh", "app " fora de nomes próprios, "ligar/desligar" para estados).
+6. Ligar tudo no CI (`npm test` ou o job existente) e exigir verde antes de merge.
+
+Saída da fase: linha de base numérica por superfície e CI que impede regressão.
+
+## 3. Fase 2: vocabulário e qualidade (1 dia)
+
+Criar `docs/i18n-glossary.md` e aplicar com busca e substituição guiada, revisando cada ocorrência:
+
+| Conceito | Termo padrão | Evitar |
+|---|---|---|
+| pair / pairing | parear, pareamento, pareado | emparelhar, emparelhamento |
+| app | aplicativo (curto: app só em rótulos de espaço apertado, decidir e documentar) | app / apps misturado |
+| on / off (estado) | ativado / desativado | ligado / desligado (exceto Bluetooth e Wi-Fi como interruptor físico: decidir) |
+| phone | telefone | celular, smartphone |
+| clipboard | área de transferência | clipboard |
+| debugging | depuração | debug |
+| hotspot | ponto de acesso | hotspot |
+
+Regras de revisão:
+- Tratamento por "você" em todo texto; sem "tu".
+- Sentence case nos textos corridos; Title Case só onde o inglês também usa (títulos de aba).
+- Mesmo texto em inglês, mesma tradução (já garantido pelo mesclador; checar as 82 divergências antigas).
+- Gênero e concordância com `{phone}`, `{name}`, `{me}`: reescrever frases que dependem do gênero do nome
+ (ex.: "{phone} pode ser encontrado") para forma neutra ("É possível encontrar {phone} enquanto...").
+- Revisão por falante nativo de 100% dos textos longos (mais de 60 caracteres, ~450 chaves) e de uma amostra de
+ 20% dos curtos. Registrar as correções no próprio PR.
+
+Saída da fase: qualidade 9,5; `i18n-glossary.js` verde.
+
+## 4. Fase 3: cobertura (3 a 5 dias, lotes paralelos)
+
+Método já provado: lotes sem arquivos em comum, cada um grava um fragmento JSON de chaves novas, um único
+passo de mescla grava os dicionários, a validação roda no fim. Regras do lote: inglês idêntico ao original;
+tokens do `UI.fill` ficam no texto; sem concatenar fragmentos; plural em `_one`/`_other`; não traduzir logs,
+texto comparado no código, mensagens para o outro dispositivo, marcas.
+
+Ordem por ganho de nota e risco:
+
+1. **Mesh** (maior lacuna: ~231 literais). `windows/mesh/ui-{cursor,multi,overview,phone,share}.js`,
+ `linux/mesh/ui-{cursor,multi,overview,phone}.js`, `mac/mesh/ui-{cursor,display,multi,overview}.js` e o que
+ restar em `mesh/app.js`/`ui-start.js` (estados do pareamento, "Phase N"). Reaproveitar as chaves das páginas
+ não-mesh quando o inglês for igual.
+2. **Janelas pequenas** (~66 literais): HUD, monitor, appview, phoneview, sender, sound, appsend, audio,
+ capture, pcview. HTML com `data-i18n*` e `shared/i18n-dom.js`; renderers com `t()`.
+3. **Processo principal** (~53 literais): `callaudio.js`, `apps.js`, `phone-bridge.js`, `smb.js`, `sshd.js`,
+ `vdd.js`, `firewall.js`, `kvm.js` e os equivalentes de Linux e macOS. Antes de embrulhar, procurar o texto no
+ código e nos testes: se for comparado ou casado por regex, não mexer.
+4. **Assistente do `aurora-shell.js`** (~41 literais de `shared/ui-*`): exemplos e respostas. Decidir se os
+ comandos de voz/texto aceitos também ganham versão em português (se não, documentar que o assistente
+ entende só inglês e traduzir apenas a interface).
+5. **Android**: `Clip.kt` e `Input.kt` (textos que sobraram); revisar plurais e os 3 `Text("...")` restantes.
+6. **Estados de erro do backend**: mensagens montadas nos módulos que viram `state.message`; traduzir na origem
+ (o idioma já está definido no processo principal).
+
+Meta por lote: o contador de `i18n-coverage` cai ao nível da meta (≤1%); atualizar o limite gravado no teste.
+
+## 5. Fase 4: verificação em app rodando (2 dias, precisa das máquinas)
+
+Nada disso foi feito até hoje.
+
+1. **Android**: instalar JDK 17+ e Android SDK; `./gradlew :app:assembleDebug`; corrigir o que o compilador
+ acusar; testar em emulador/aparelho em Português (Brasil) e English.
+2. **Desktop**: rodar o app em Windows, macOS e Linux (X11 e Wayland) com `lang` = `auto`, `en`, `pt-BR`.
+ Checklist por plataforma:
+ - cada aba abre sem erro no console; trocar o idioma recarrega e muda nav, cabeçalhos, descrições e bandeja;
+ - pareamento completo (outro computador e telefone): banner, códigos, estados;
+ - modo Multi-device (mesh) e as janelas pequenas;
+ - sem texto cortado ou sobreposto em 1366×768, 1440×900 e 375×812;
+ - inglês idêntico ao de `origin/main` (comparar capturas de 3 páginas por plataforma).
+3. **Captura automatizada**: com Playwright (já usado para Electron), um teste de fumaça que abre cada aba em
+ `pt-BR` e falha se achar texto da lista de "palavras inglesas" (the, and, with, click, open...) fora das
+ exceções. Roda no CI quando houver runner gráfico.
+4. **Site**: `node website/dev-server.js`; EN e PT, `/404`, recarga com PT salvo (sem flash), CSP sem erro.
+
+## 6. Critérios de aceite para 9,5
+
+- Os cinco testes novos passam no CI; `applog`, `kvm-moves`, `movebench` continuam fora (já falham em `origin/main`).
+- `docs/i18n-coverage.md` mostra ≤1% de literais em inglês em todas as superfícies, com a lista de exceções.
+- `i18n-glossary.js` verde; nenhuma ocorrência de "emparelh", "celular", "tu/teu".
+- 100% dos textos longos revisados por falante nativo, com registro das correções.
+- Android compila e foi percorrido em pt-BR; desktop percorrido nas 3 plataformas com o checklist acima.
+- Nenhuma regressão no inglês (portão de padrão em inglês + comparação de capturas).
+
+## 7. Cronograma e dependências
+
+| Etapa | Dias | Depende de |
+|---|---|---|
+| Fase 1: portões | 0,5 | nada |
+| Fase 2: vocabulário e revisão | 1 | Fase 1 (glossário no CI) |
+| Fase 3: lotes 1 a 3 | 2 a 3 | Fase 1 (limite de cobertura) |
+| Fase 3: lotes 4 a 6 | 1 a 2 | lotes 1 a 3 |
+| Fase 4: verificação em app | 2 | JDK/SDK e uma máquina de cada sistema |
+| Merge e publicação | conforme o plano de 31/10 | fases 1 a 4 |
+
+As fases 2 e 3 podem andar em paralelo. A Fase 4 é o gargalo: sem ela a nota de robustez não passa de 9,0,
+porque o que foi medido até agora é código, não o app em uso.
+
+## 8. Riscos
+
+| Risco | Mitigação |
+|---|---|
+| Embrulhar texto que o código compara e quebrar lógica | procurar o texto no código e nos testes antes; testes de `shared/test` no fim de cada lote |
+| Conflito de chaves entre plataformas | mesclador cria variantes `_linux`/`_mac`; o portão de padrão em inglês acusa divergência |
+| Texto fixado na carga do módulo (idioma ainda não definido) | traduzir no uso/renderização; o teste de fumaça pega |
+| Limite de cobertura virar burocracia | limite só desce; exceções em arquivo versionado e revisado no PR |
+| Revisão nativa atrasar | começar a revisão da Fase 2 enquanto a Fase 3 corre; revisar só o delta nas rodadas seguintes |
diff --git a/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md b/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md
new file mode 100644
index 00000000..f93de974
--- /dev/null
+++ b/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md
@@ -0,0 +1,40 @@
+# Notas da release: Português (Brasil) — rascunho
+
+Rascunho para a release que trouxer o pt-BR. A versão e a data ficam para quem publicar
+(o `package.json` do desktop está em 2.5.0; nada foi alterado nas versões).
+
+## English
+
+**DuoDesk now speaks Brazilian Portuguese.**
+
+- Desktop (Windows, macOS, Linux): every page, the tray / menu bar, pairing, notifications and the small
+ windows follow the language. Pick it in **General › Language**: Automatic (system), Português (Brasil) or English.
+- Android: the whole app is available in Portuguese (it follows the system language).
+- Website and README: Portuguese versions (`README.pt-BR.md`, `docs/*.pt-BR.md`, EN / PT switch on the site).
+- Fixes found along the way: the Camera, Messages, Calls, Media, Files and Support tabs could fail to load
+ on some pages because several scripts declared the same top-level name.
+
+Known limits: the assistant bar only understands English commands; messages sent to the other computer
+or phone are shown in the sender's language.
+
+## Português (Brasil)
+
+**O DuoDesk agora fala português do Brasil.**
+
+- Desktop (Windows, macOS, Linux): todas as páginas, a bandeja / barra de menus, o pareamento, as notificações e as
+ janelas pequenas seguem o idioma. Escolha em **Geral › Idioma**: Automático (sistema), Português (Brasil) ou English.
+- Android: o app inteiro está disponível em português (segue o idioma do sistema).
+- Site e README: versões em português (`README.pt-BR.md`, `docs/*.pt-BR.md`, alternância EN / PT no site).
+- Correções feitas no caminho: as abas Câmera, Mensagens, Chamadas, Mídia, Arquivos e Suporte podiam não carregar em
+ algumas páginas, porque vários scripts declaravam o mesmo nome no topo do arquivo.
+
+Limites conhecidos: a barra do assistente só entende comandos em inglês; as mensagens enviadas ao outro computador
+ou ao telefone aparecem no idioma de quem envia.
+
+## Antes de publicar
+
+- [ ] Compilar e testar o Android em pt-BR e em inglês.
+- [ ] Rodar o desktop nas 3 plataformas (`auto`, `en`, `pt-BR`) com o checklist do plano de 01/11.
+- [ ] Definir a versão, atualizar os links de download do `README.md` e do `README.pt-BR.md`.
+- [ ] Gerar os instaladores e conferir que `shared/locales/` e `shared/i18n-dom.js` estão no pacote.
+- [ ] Deploy do site na Vercel (preview primeiro).
diff --git a/flake.nix b/flake.nix
index 2c46d4a7..f008d4bd 100644
--- a/flake.nix
+++ b/flake.nix
@@ -97,7 +97,7 @@
# Copy shared files
cp -r shared/*.js shared/*.css shared/*.html "$share/shared/"
# The pages' fonts (Geist woff2 + OFL.txt), the art kit and scenes, the per-page effects
- cp -r shared/fonts shared/art shared/pagefx "$share/shared/"
+ cp -r shared/fonts shared/art shared/pagefx shared/locales "$share/shared/"
if [ -d shared/icon ]; then
cp -r shared/icon "$share/shared/"
fi
diff --git a/linux/app.html b/linux/app.html
index d3db63ac..ad731ffe 100644
--- a/linux/app.html
+++ b/linux/app.html
@@ -23,7 +23,7 @@
-