Ajuda

Procura um passo a passo completo? Veja o Manual do Monad.

Guias curtos para os recursos que o aplicativo Monad abre a partir de botões como "Precisa de ajuda?" e "Ver guia de solução de problemas".

Atualizar o Monad

A versão 1.25.29 traz a nova identidade azul, ícones renovados, uma página inicial mais organizada e a versão visível na barra de título.

1. No aplicativo instalado, abra Conta (o ícone de pessoa no menu) e clique em Verificar atualizações.
2. Aguarde a transferência e escolha Reiniciar para atualizar.
3. Depois da reinicialização, confira a versão na barra de título.

O Monad instalado no Windows também verifica atualizações automaticamente a cada hora. Se ainda não instalou o aplicativo, transfira o instalador atual para Windows 64 bits. Executar uma cópia de desenvolvimento ou um executável sem instalar não ativa esse fluxo.

GitHub

Ligue o Monad ao GitHub em Definições do app para publicar o código e manter um repositório sincronizado.

Solução de problemas

• Se a ligação falhar, desligue e ligue de novo; o código de autorização expira em poucos minutos.
• Se o envio for recusado, confira se o repositório existe, se você tem permissão de escrita e se a branch escolhida é a certa.
• Se houver conflito com o que já está no GitHub, resolva-o ou escolha outra branch antes de enviar.
• O Monad mostra o texto completo do erro quando ele vem do Git; copie-o ao pedir ajuda.

App para telemóvel (Capacitor)

O botão "Atualizar para app híbrido com Capacitor" adiciona o Capacitor ao seu projeto, para que ele execute em iOS e Android além da web. Para fazer à mão, instale @capacitor/core, @capacitor/cli e as plataformas que quiser, depois execute npx cap init e npx cap add android (ou ios).

Solução de problemas

• Para Android é preciso o Android Studio; para iOS, um Mac com Xcode.
• Depois de mudar o código web, gere a versão de produção e execute npx cap sync antes de abrir o projeto nativo.
• Se o projeto nativo não abrir, confirme que as ferramentas da plataforma estão instaladas e no PATH.

Selecionar componente para editar

A atualização "Ativar seleção de componente" instala o plugin do Vite que marca cada componente do preview. Assim você clica no que quer mudar e o Monad sabe exatamente qual ficheiro e qual linha editar. Para instalar à mão, adicione o plugin do Monad ao vite.config e instale as dependências dele; o botão faz isso por você e é a forma recomendada.

Migrar para a versão atual do pnpm

O Monad usa o próprio pnpm, que grava o ficheiro de travamento (pnpm-lock.yaml) num formato que versões antigas do pnpm não leem. Se o seu app ainda declara um pnpm antigo em packageManager, o aviso aparece no console. A migração atualiza o packageManager e o lockfile juntos, para que o preview, o CI e quem transferir o projeto usem a mesma versão.

• Antes de migrar, faça um commit com o estado atual.
• Se você publica o app em outro lugar, atualize a versão do pnpm lá também.

Migração de banco (modelo Portal)

"Gerar migração de banco" cria um novo ficheiro de migração a partir das mudanças no esquema e o guarda num commit. Revise o ficheiro gerado antes de aplicá-lo a um banco com dados reais.

Revisão de segurança

A revisão de segurança lê o código do app e lista achados por gravidade (crítico, alto, médio, baixo). Use "Corrigir" para pedir ao Monad que resolva os achados selecionados. Trate o resultado como um apoio, não como uma auditoria completa: segredos, políticas de banco e permissões merecem revisão humana.

Restaurar as Definições a partir de um backup

Se o Monad avisar que não conseguiu ler o ficheiro de Definições e voltou ao padrão, os dados anteriores não foram apagados. Feche o Monad e vá até a pasta de dados dele (no Windows, %APPDATA%\Monad). Lá estão:

• user-settings.json, o ficheiro atual;
• user-settings.json.bak, a cópia anterior;
• ficheiros user-settings.json.recovery-…bak, guardados quando o Monad precisou recuperar o ficheiro.

Copie o backup que quiser por cima de user-settings.json (guarde antes uma cópia do ficheiro atual) e abra o Monad de novo.