Por Que Reescrevemos Tudo em Rust

Uma das decisões mais importantes na história do Openfoot Manager foi reescrever completamente o motor do jogo, migrando de Python para Rust, e usar React no frontend. Aqui explico por que tomámos essa decisão, o que ganhámos com ela e para onde estamos a ir.

O início do projeto

O Openfoot Manager começou em 2020 como um projeto em Python. Python foi uma escolha natural para mim: é uma linguagem acessível, com um ecossistema muito rico, e era a linguagem com a qual eu tinha mais familiaridade na altura. Além disso, gosto muito de escrever em Python e valorizo bastante a sua comunidade.

Os primeiros protótipos surgiram quando eu ainda não sabia exatamente o que estava a fazer. Testei muitas ideias para construir uma simulação de jogos sólida. Elas funcionavam, mas transformar isso num projeto completo e bem estruturado foi um grande desafio.

Quando comecei a trabalhar no primeiro MVP, eu tinha várias opções de GUI disponíveis. Eu não queria usar frameworks de frontend em JavaScript (já tinha tido experiências más no passado), então acabei por escolher o ttkbootstrap para a primeira versão do projeto.

Noutro projeto, eu utilizava PySimpleGUI e, desta vez, queria experimentar algo diferente.

Rapidamente ficou claro que trabalhar com widgets ttk era bastante frustrante. Precisei de escrever alguns widgets de raiz e, ainda assim, tive muita dificuldade para implementar coisas simples. O backend foi mais tranquilo: com o tempo, consegui construir um motor capaz de gerar os dados necessários para a simulação dos jogos. Depois de muitas tentativas, cheguei a um motor de simulação bom o suficiente.

A GUI, no entanto, continuava a ser um problema, e eu queria resolvê-la sem recorrer ao JavaScript. Tentei de tudo. Também experimentei Qt, mas não me agradou. No fim, acabei por criar uma solução bastante ousada: um backend com Flask, um frontend usando templates Jinja2 para renderizar o HTML e, para imitar o comportamento do React, o uso de HTMX em conjunto com AlpineJS.

Mais tarde, substituí o Flask pelo FastAPI e reescrevi todo o backend usando SQLModel, que combina Pydantic e SQLAlchemy. Para o visual, utilizei Tailwindcss.

Para entregar a experiência desktop que eu desejava, integrei o Pywebview e utilizei o uvicorn como servidor web para permitir a comunicação entre o FastAPI e o Pywebview.

Essa solução Frankenstein acabou por ser extremamente difícil de manter. Percebi que estava a complicar as coisas em vez de simplificá-las. Conseguir uma boa performance com Pywebview era difícil, e empacotar a aplicação como software desktop continuava a ser um problema sem solução clara. Eu estava quase a dizer aos utilizadores para simplesmente iniciarem o servidor e abrirem o jogo no navegador.

Também tentei integrar Python com React, mas a experiência não foi boa, nem para desenvolvimento nem para UX.

Rust ao resgate

Eu programo em Rust há bastante tempo. É uma linguagem muito poderosa, mas também bastante exigente. Não é fácil acertar tudo à primeira, mas em troca ela oferece desempenho excelente e alta fiabilidade. Além disso, a comunidade é extremamente envolvida e alinhada com o tipo de projeto que eu queria construir.

Tauri foi um dos projetos que mais me chamou a atenção. Se a ideia era evitar tecnologias muito dependentes de JavaScript, como o Electron, o Tauri parecia o caminho certo.

A minha ideia inicial era usar Tauri com Leptos no frontend, criando uma stack totalmente baseada em Rust. Na prática, isso mostrou-se muito mais complexo do que eu esperava. Rust no frontend é poderoso, mas pouco agradável de trabalhar.

Então, optei por uma abordagem mais pragmática: manter Rust no backend, continuar a usar o Tauri e adotar React no frontend. Desta vez, precisei de mexer muito pouco no código React. As ferramentas de IA têm ajudado bastante no desenvolvimento frontend, especialmente com estilização e todo o boilerplate que eu não gosto de escrever.

No fim das contas, foi a combinação perfeita.

O que ganhámos com esta mudança

Olhando para trás, fica claro quão difícil foi esta jornada. Eu realmente tentei fazer Python funcionar, por amor à linguagem, mas simplesmente não era a melhor escolha para este projeto. Ainda assim, espero poder construir algo desta dimensão em Python no futuro.

No final, trocámos uma solução extremamente complexa baseada em FastAPI + SQLModel + Pywebview + HTMX + Jinja2 + AlpineJS + uvicorn por algo muito mais simples: Tauri + Rust + React. Mais simples, mais robusto e já bem testado.

Além de recuperar a minha sanidade, ganhámos muito mais estabilidade, desempenho e uma experiência muito melhor para o utilizador final. O projeto também se tornou muito mais fácil de entender e de receber contribuições de outros programadores.

Na stack antiga, era necessário usar uv para instalar dependências e executar vários scripts para iniciar o backend e o frontend.

Com a nova stack, basta ter Rust e NodeJS instalados e correr npm run tauri dev para iniciar todo o ambiente de desenvolvimento, com hot-reloading ativado — algo que não existia antes. Uma experiência de desenvolvimento simplesmente excelente.

A olhar para o futuro

A reescrita em Rust não foi apenas uma melhoria técnica. Ela representa a base de tudo o que queremos construir daqui para a frente: mais estabilidade, melhor desempenho, uma ótima experiência para programadores e uma interface bonita para os utilizadores.

O jogo ainda está em desenvolvimento inicial, mas a base é sólida. Estamos muito entusiasmados com o que vem a seguir.