1
Ver o projeto
O Refract olha para o software como um todo, para uma alteração num ecrã poder respeitar o resto.
De código gerado a código que podes manter.
O Refract lê o projeto, encontra o que se vai tornar uma confusão, e prepara uma limpeza que tu aprovas. Nunca sais do GitHub para decidir.
ComeçarUm ciclo simples
2
Encontrar o que vai doer mais tarde
Procura os padrões que aparecem quando o código é gerado à pressa: lógica copiada, ecrãs emaranhados, estado a mais, estrutura que não envelhece bem. Se ficou qualquer coisa sensível no código — como uma credencial — diz-te. Não «corrige» segredos em silêncio.
3
Limpar o que puder
Quando a limpeza é segura, recebes uma alteração concreta para aprovar. Quando não é, recebes uma explicação clara em vez de um palpite.
4
Verificar, e depois lembrar
Depois de aprovares, o Refract aplica a alteração e volta a olhar. Com o tempo podes ver se o projeto está a ficar mais limpo — ou se continua a lançar a confusão.
Decide no GitHub. Usa o site para o resto.
No GitHub
No site
O site não é um segundo sítio para aceitar limpezas. A decisão fica ao lado do código.
Vais ver um de poucos resultados honestos
Ainda a trabalhar
Espera. Isto ainda não passou.
Parece limpo
Nada do Refract precisa de ti nesta alteração.
Limpeza pronta
Há uma limpeza segura preparada. Aprova-a no GitHub.
Dá uma vista de olhos
Há qualquer coisa que importa, e o Refract não a vai alterar por ti. Lê a explicação.
Algo correu mal
A análise falhou. O Refract diz-te. Não pinta um sucesso falso.
O que «mais limpo» quer dizer na prática
Em projetos React e TypeScript, o Refract é especialmente bom nos restos de uma geração rápida:
pedidos de dados misturados na interface
a mesma lógica escrita duas vezes
estado que nunca é mesmo usado
efeitos que não se limpam a si próprios
timeouts em falta e tratamento de erros em falta nas extremidades
ecrãs a fazer trabalho que pertence a outro sítio
Uma parte disto pode limpar por ti. Outra parte, só aponta — de propósito. Uma reescrita automática má é pior do que uma nota honesta.
A funcionar em minutos
1
Cria uma conta
2
Instala a GitHub App e escolhe repositórios
3
Abre um pull request
Ligar o GitHub não inicia sessão no Refract, e iniciar sessão no Refract não instala o acesso ao GitHub. Dois passos, dois trabalhos.
Isto vai lutar com as minhas ferramentas de IA?
Não. Continua a gerar. O Refract é o passo que deixa o resultado fácil de manter.
Vai alterar código sem mim?
Não. Tu aprovas. Tu fazes merge.
Tenho de aprender um espaço de trabalho novo?
Não. No dia a dia, ficas no GitHub.