Quando algo falha

Comece por npx verbaly doctor. Ele inspeciona o setup inteiro e imprime a correção exata ao lado de cada achado, então quase toda esta página é o que ele lhe teria dito.

O comando verbaly não existe

O comando vive em @verbaly/compiler. Os plugins dependem dele, mas um gestor de pacotes só liga o comando de um pacote que você mesmo instalou, então não basta um plugin trazê-lo. Adicione-o às suas dependências de desenvolvimento:

pnpm add -D @verbaly/compiler

Apareceu um idioma que eu nunca pedi

Se você não listar locales, cada ficheiro JSON da sua pasta de catálogos conta como um idioma, então um deixado por uma execução anterior também é, e o build passa a pedir as traduções dele. Liste os seus idiomas e a lista fica completa:

locales: ['es', 'en']  // now a stray pt.json is ignored

o wrap reportou ficheiros que não escreveu

Um ficheiro onde t não está disponível é listado e fica intacto, porque envolver texto ali deixaria o seu projeto sem compilar. O relatório diz quantos textos esperam em cada um e se é um componente de cliente, para você saber que linha adicionar. Adicione-a e execute de novo.

O build diz que uma tradução está quebrada

Não falta, está quebrada: a tradução existe e não consegue renderizar o que a sua fonte renderiza. Perdeu um {valor}, deixou cair um caso do plural ou mudou uma etiqueta. Execute npx verbaly check para ver o motivo exato de cada mensagem. failOnMissing: false não as silencia de propósito, porque renderizam errado.

Aparece uma key no ecrã em vez do texto

Uma mensagem que não resolve em lado nenhum renderiza-se como a sua própria key. Normalmente o catálogo desse idioma ainda não chegou, ou o grupo é um que você excluiu do navegador com bundle.exclude e algo o pede em runtime. O build avisa do segundo caso pelo nome.

As minhas keys não estão tipadas, ou os tipos estão velhos

Os tipos são gerados pelo extract a partir do seu catálogo fonte, então são tão velhos quanto a sua última execução. Se o seu editor não os vê de todo, verifique se o ficheiro gerado está dentro do seu tsconfig, ou aponte dts para um sítio onde esteja.

Não se consegue importar t do verbaly

Nenhum pacote exporta t. Ele vem do módulo próprio do seu projeto, virtual:verbaly, ou do hook do seu framework. O doctor reporta este como erro porque nenhum bundler o consegue resolver.