Pitch: Portei um app Electron pra Go + Wails: o pacote caiu de 97 MB pra 8 MB. O que deu certo e o que quebrou
Mantenho o Zeno, um cliente de API desktop open source (MIT). Ele nasceu de uma irritação: o cliente que eu usava passou a abrir cada request numa aba nova, sem opção pra desligar, além de exigir conta e guardar as coleções de um jeito difícil de versionar. Então escrevi o que eu queria usar: uma tela só, coleções em arquivos YAML que vão pro git, segredos cifrados dentro do próprio YAML e import direto do Insomnia.
A primeira versão foi em Electron. Funcionava, mas um cliente de API fica aberto o dia todo do lado da IDE, do navegador e do Slack, e cada um desses já carrega um navegador inteiro. Pagar ~100 MB de download e ~350 MB de memória pra uma ferramenta cujo trabalho principal é mandar HTTP e mostrar JSON me incomodava. E eu queria o backend em Go, que é a linguagem que uso no dia a dia.
Este post é sobre como foi portar pra Go com Wails, mantendo a interface em React.
Os números
| Electron | Go + Wails | |
|---|---|---|
| Pacote | 97 MB | 8 a 24 MB (depende do sistema e do formato) |
| Memória parado | ~350 MB | ~220 MB |
| Backend | Node.js | Go |
| Renderização | Chromium embutido | navegador do sistema (WebKitGTK, WebView2, WKWebView) |
Antes de decidir, fiz dois spikes com o mesmo workspace de 1.000 requests: Go + Wails e uma opção só com GTK. O Wails ganhou: memória e tamanho perto da opção nativa, mas rodando também no Windows e no macOS e reaproveitando a interface React.
A decisão que tornou o porte possível
A interface só conversava com o backend por um objeto tipado, window.zeno (no Electron, era o contextBridge do preload). Essa foi a decisão mais valiosa do projeto inteiro.
Na versão Wails, window.zeno virou um Proxy: toda chamada de método vira uma chamada a um único método Go, App.Call(canal, args), que despacha pra um mapa de handlers. Eventos do Go (resposta chegou, arquivo mudou no disco, stream) passam pelo runtime do Wails. O React não precisou saber que nada mudou.
w.zeno = new Proxy({}, {
get: (_t, k) => special[k] ?? ((...args) =>
w.go.main.App.Call(k, args.map((a) => JSON.stringify(a ?? null))).then(fillBodies))
})
Na prática, o porte foi reescrever os handlers em Go, um por um.
Manter os dados de quem já usava
Quem já tinha workspaces, histórico e o cofre cifrado da versão Electron tinha que instalar a versão Go por cima e abrir tudo.
- YAML e JSON: mesmas pastas e a mesma ordem de campos. Escrevi um tipo de documento ordenado em Go que mantém as chaves na ordem em que o Electron gravava; senão cada save viraria ruído no git.
- Importadores (Insomnia, Postman, OpenAPI): em vez de testar na mão, gerei arquivos golden com os importadores do Electron e fiz os de Go baterem com eles. "Ficou igual?" virou um diff.
- A chave do cofre: o
safeStoragedo Electron cifra com uma chave que fica no chaveiro do sistema, no formato OSCrypt do Chromium. Pra abrir o cofre antigo, a versão Go lê o mesmo item do chaveiro (Secret Service no Linux, DPAPI no Windows, Keychain no macOS) e faz a mesma derivação de chave.
O que quebrou
Respostas grandes pela ponte. O Wails passa resultados como string JSON. Um body de 50 MB passava por JSON.stringify de um lado e JSON.parse do outro, e no WebKitGTK isso levava mais de um segundo (no Electron, ~0,4 s). A solução: bodies acima de 64 KB não passam pela ponte. O Go guarda na memória e devolve um token; a interface busca /zeno-body/<token> no servidor de assets do próprio app. A ponte só carrega metadados.
<select> nativo no WebKitGTK. Abre um popup GTK que ignora o tema do app. Com 20 temas, ficava feio. Troquei todos por um componente próprio, com teclado e ARIA. Deu mais trabalho do que eu esperava, mas agora fica igual nos três sistemas.
Memória que não voltava. O Go devolve memória pro sistema operacional sem pressa. Depois de um request grande, o RSS ficava alto mesmo com o heap pequeno. Um "trim" chama debug.FreeOSMemory() um segundo depois que o heap passa de 64 MB, e a memória em repouso voltou a cair.
GPU no Linux. Em algumas configurações, a composição por GPU do WebKitGTK fazia a rolagem e a digitação esperarem o vsync do compositor. O padrão no Linux virou composição por software, que pra essa interface ficou mais rápida, com uma variável de ambiente pra voltar.
Plugins. Os plugins do Insomnia são módulos Node. Sem Node, eles rodam no goja, um interpretador JavaScript em Go, com shims das APIs que os plugins de fato usam. Alguns módulos do Node ainda não existem.
Testar o app de verdade, não só o backend
Os testes unitários cobriam os pacotes Go, mas o risco de um porte está na cola entre as partes. Criei um teste ponta a ponta: uma variável de ambiente faz o app rodar um script JavaScript dentro da própria janela depois de carregar. O script conversa com window.zeno do mesmo jeito que a interface, manda requests pra um servidor de teste local (HTTP, redirects, cookies, OAuth, GraphQL, WebSocket, SSE, gRPC) e imprime PASS/FAIL. O CI roda isso sob Xvfb em todo PR: hoje são 62 verificações em uns 15 segundos.
Depois do porte, funcionalidade ficou mais barata
Com o backend em Go, as versões seguintes ganharam coisas que seriam mais pesadas em Node: gRPC com server reflection ou .proto compilado na hora (protocompile + dynamicpb), WebSocket e Server-Sent Events, OAuth 2.0 com callback em loopback, proxy/CA própria/mTLS por workspace e um mock server local a partir de respostas salvas. Cada um é um pacote Go pequeno, com seus testes. Na 1.2, a interface e as mensagens passaram a sair em inglês por padrão (português é uma opção nas Preferências), com testes que falham se algum texto ficar sem tradução, no React e no Go.
Faria de novo?
Sim. O que fez diferença:
- Uma ponte estreita entre interface e backend. O porte virou reescrever handlers.
- Testes golden gerados pela implementação antiga. "Está igual?" virou um diff.
- Um teste ponta a ponta que dirige o app real. Pegou bugs que teste unitário não pegaria.
O custo é conviver com três navegadores de sistema diferentes, e o WebKitGTK pede cuidado. Pra uma ferramenta que fica aberta o dia todo, compensa.
O Zeno é MIT: github.com/chmenegatti/zeno. Tem .deb, .rpm, AppImage, instalador Windows e .dmg na página de releases, e também brew install --cask chmenegatti/tap/zeno e Scoop. Se você guarda coleções de API no git, quero saber o que falta pra você. Issues e PRs são bem-vindos, e tem algumas marcadas como good first issue.