Guia de instalacao

Instale o Writtt no seu proprio PC.

Nao precisa saber programar. Este guia mostra dois caminhos: o facil (so baixar e instalar) e o tecnico (compilar voce mesmo a partir do codigo-fonte).

Escolha o que faz mais sentido pra voce. Os dois chegam no mesmo resultado: Writtt rodando na sua maquina, pertencendo a voce.

A

Caminho mais facil - recomendado

So baixar e instalar

Compilamos o Writtt e disponibilizamos como arquivo pronto para cada sistema operacional. Clique no botao do seu sistema, rode o instalador e pronto. Sem terminal, sem comandos.

🪟

Windows

.exe installer

🍎

macOS

.dmg (Apple Silicon + Intel)

🐧

Linux

.AppImage / .deb / .rpm

E o mesmo codigo que esta no GitHub - a gente so pre-compilou para voce nao precisar.
No Windows ou macOS, o sistema pode mostrar um aviso de seguranca na primeira vez. Isso e normal para apps nao assinados. Clique em Mais informacoes e depois Executar assim mesmo (Windows) ou clique com o botao direito e depois Abrir (macOS).
ou, se quiser compilar voce mesmo
B

Para os curiosos - compilar do codigo-fonte

Compile voce mesmo

Compilar do codigo-fonte significa ler cada linha antes de rodar. Sem surpresas. Leva cerca de 10 a 20 minutos na primeira vez.

Primeiro: o que e um terminal?

Um terminal (tambem chamado de Prompt de Comando ou console) e uma janela de texto onde voce digita comandos. Nao se preocupe - voce vai apenas copiar e colar os comandos abaixo. Veja como abrir no seu sistema:

🪟 Windows

Tecla Win + R

→ digita "cmd"

🍎 macOS

Cmd + Espaço

→ "Terminal"

🐧 Linux

Ctrl + Alt + T

ou busca "Terminal"

O que voce precisa instalar antes

Go≥ 1.21

A linguagem de programacao em que o Writtt foi escrito. Pense como o motor do app.

baixar
Node.js≥ 18

Usado para construir a interface visual (botoes, fontes, layout). Baixa em segundos.

baixar
Wails CLIv2.x

A ferramenta que une o Go e a interface em um unico aplicativo.

baixar
01

Instale o Wails (a ferramenta de compilacao)

Depois de instalar o Go, abra o terminal e cole este comando. Ele baixa o Wails que vai compilar tudo:

Terminal / Prompt de Comando
go install github.com/wailsapp/wails/v2/cmd/wails@latest
Se aparecer wails: command not found, feche o terminal, abra de novo e tente wails version. As vezes o terminal precisa reiniciar para encontrar ferramentas novas.
02

Baixe o codigo-fonte do Writtt

Este comando copia todo o codigo do GitHub para o seu computador (numa pasta chamada writtt):

Terminal
git clone https://github.com/marcelomatz/writtt.git
cd writtt
Nao precisa de conta no GitHub. git ja vem instalado no macOS/Linux. No Windows, instale o Git for Windows em git-scm.com se precisar.
03

Instale as dependencias JavaScript

A interface do Writtt e feita em React. Este passo baixa os blocos visuais necessarios (fontes, icones, layout). Pode levar 1 a 2 minutos:

Terminal (dentro da pasta writtt)
npm install
Vai aparecer muito texto rolando - e normal. Sao so pacotes sendo baixados. Aguarde terminar e voltar para a linha em branco.
04

Rode o Writtt (modo visualizacao)

Este comando abre o Writtt direto do codigo-fonte. Use para verificar se tudo funciona antes de gerar o arquivo final:

Terminal
wails dev
O Writtt deve abrir em alguns segundos. E o app de verdade - nao so uma previa.
05

Compile seu proprio binario

Quando estiver satisfeito com a visualizacao, rode este comando para criar um arquivo unico que voce pode copiar para qualquer lugar:

Terminal
wails build
Pronto! Seu arquivo esta em build/bin/writtt (macOS/Linux) ou build/bin/writtt.exe (Windows). Voce pode copiar para a Area de Trabalho, compartilhar, ou guardar como backup.

Por que passar por tudo isso?

Binarios pre-compilados sao convenientes, mas exigem confianca. Quando voce compila do codigo-fonte, voce verifica o binario em vez de esperar que esteja limpo.

O Writtt nao faz nenhuma chamada de rede em runtime - sem telemetria, sem pings, nada. Compilar voce mesmo permite confirmar isso diretamente no codigo antes de rodar.

Duvidas, contribuicoes ou problemas - tudo esta no GitHub.

Ver codigo-fonte no GitHub