Repolode
blackboardsh

blackboardsh/electrobun

Framework multiplataforma para criar apps desktop pequenos e rápidos com TypeScript no processo principal e webviews, com suporte também a Zig, Rust, Go e Odin.

Alternativa open source a:Electron

Estrelas
12,939
Forks
374
Issues abertas
146
Último commit
anteontem

O que é?

Electrobun é um framework para criar, atualizar e distribuir aplicativos desktop multiplataforma. A lógica da aplicação é executada em um processo principal baseado em Bun e escrito em TypeScript, enquanto a interface é renderizada em webviews isoladas. Um RPC tipado conecta os dois processos, permitindo manter o código do processo principal e das webviews em uma única base de código com segurança de tipos.

O projeto prioriza apps pequenos e atualizações eficientes. Seus bundles autoextraíveis usam compressão Zstandard, e as atualizações são distribuídas como patches binários (BSDIFF), com fallback para um download completo compactado. A opção bundleCEF fixa a versão do Chromium para garantir renderização consistente, ao custo de arquivos maiores, enquanto a opção bundleWGPU permite que o TypeScript controle uma superfície de GPU nativa sem webview.

O Electrobun inclui o Hutch, uma CLI nativa de build e workspace que gerencia SDKs e toolchains. É possível iniciar projetos a partir de templates com `hutch electrobun init`, `bunx electrobun init` ou `npx electrobun init`. O suporte oficial a plataformas inclui macOS 14+, Windows 11 x64 e Ubuntu 24.04+.

Recursos principais

  • 01Escreva o código do processo principal e das webviews em TypeScript, com RPC tipado entre eles
  • 02Bundles autoextraíveis compactados com Zstandard
  • 03Atualizações por patches binários (BSDIFF), com fallback para download completo
  • 04Chromium (CEF) integrado como opção ou superfície WebGPU
  • 05O processo principal também pode usar Zig, Rust, Go ou Odin

Casos de uso

  • Distribuir uma ferramenta desktop pequena em TypeScript que precise de atualizações frequentes e com baixo consumo de banda
  • Criar uma interface desktop para um app existente em Bun ou para um app web
  • Integrar renderização nativa com GPU a uma interface baseada na web

Início rápido

  1. 1

    Instale a Hutch CLI com o script oficial (macOS ou Linux)

  2. 2

    Comece pelo npm, sem instalar o Hutch

    npx electrobun init
  3. 3

    Escolha um template e siga o guia Quick Start para executar o app

Antes de usar

  • Os sistemas Linux dos usuários finais precisam ter instalados os pacotes de runtime do GTK 3, WebKitGTK 4.1, Ayatana AppIndicator e librsvg.
  • Cottontail, a alternativa de runtime baseada em JSC, é experimental.

Tópicos

Perguntas frequentes

O que é electrobun?
Framework multiplataforma para criar apps desktop pequenos e rápidos com TypeScript no processo principal e webviews, com suporte também a Zig, Rust, Go e Odin. Electrobun é um framework para criar, atualizar e distribuir aplicativos desktop multiplataforma. A lógica da aplicação é executada em um processo principal baseado em Bun e escrito em TypeScript, enquanto a interface é renderizada em webviews isoladas. Um RPC tipado conecta os dois processos, permitindo manter o código do processo principal e das webviews em uma única base de código com segurança de tipos.
electrobun é gratuito? Qual é a licença?
electrobun é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
electrobun ainda é mantido?
Manutenção ativa. O último commit de electrobun foi em 18 de out. de 2026.
Para que posso usar electrobun?
Distribuir uma ferramenta desktop pequena em TypeScript que precise de atualizações frequentes e com baixo consumo de banda Criar uma interface desktop para um app existente em Bun ou para um app web Integrar renderização nativa com GPU a uma interface baseada na web
Como instalar electrobun?
Instale a Hutch CLI com o script oficial (macOS ou Linux) Comece pelo npm, sem instalar o Hutch: npx electrobun init Escolha um template e siga o guia Quick Start para executar o app
Onde consigo electrobun?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/blackboardsh/electrobun

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados