TypeScript de ponta a ponta: menos bugs em produção
O backend muda um campo e o app quebra em produção. Tipos compartilhados entre front, app e API acabam com essa classe inteira de bugs.
Por Roger C. Ribeiro, fundador da Wecodex3 min de leitura
O backend muda um campo e o app quebra em produção. Tipos compartilhados entre front, app e API acabam com essa classe inteira de bugs.
Um dev renomeia telefone para celular na API. O site continua mandando telefone, o app também. Nenhum erro aparece até um cliente reclamar que o cadastro "não salva". Esse bug não é falta de atenção: é falta de um contrato que todos compartilham.
A ideia
Quando web, app e backend são escritos em TypeScript, os tipos dos dados que trafegam entre eles podem viver num lugar só. Mudou o contrato, o compilador aponta cada tela que precisa de ajuste — antes do deploy.
Como estruturar
- Um pacote compartilhado (num monorepo) com esquemas e tipos:
Cliente,Pedido,RespostaPaginada. - Esquemas Zod como fonte da verdade: o mesmo esquema valida no servidor e no formulário e gera o tipo — veja Validação de dados com Zod e TypeScript: guia prático.
- Front, app e API importam do mesmo pacote. Nada de copiar interfaces à mão.
// packages/contratos/cliente.ts
export const ClienteSchema = z.object({ nome: z.string(), celular: z.string() })
export type Cliente = z.infer<typeof ClienteSchema>O que você ganha
- Bugs de contrato viram erros de compilação.
- Refatorações deixam de dar medo.
- O app React Native aproveita a mesma lógica do site — tema de App e site com a mesma base de código: o que compartilhar.
E se a API for pública?
Para parceiros que não usam TypeScript, gere documentação a partir dos mesmos esquemas e versione a API com cuidado, como em Versionamento de API: mudar sem quebrar o app de ninguém.
Cuidados
- Compartilhe contratos, não regras de negócio do servidor — o front não precisa saber como o desconto é calculado.
- Proíba
any. Um únicoanyno caminho apaga a garantia.
Usamos essa arquitetura nos sistemas, apps e na 
- TypeScript
- Monorepo
- APIs
- React Native
Escrito por
Roger C. RibeiroFundador da Wecodex. Escreve sobre engenharia de software, performance, APIs, segurança e IA aplicada a empresas.
Serviços relacionados
Resolver de vez, com quem faz isso todo dia
Precisa de uma API ou integração que não caia quando o negócio crescer?
Este artigo mostra o caminho. A implementação sob medida, o detalhe que muda o resultado no seu caso, é o trabalho da Wecodex, empresa de engenharia do grupo Wocom.
Continue lendo
Tudo sobre Backend & APIs- Ler artigo
Backend & APIs3 min
Validação de dados com Zod e TypeScript: guia prático
TypeScript não valida o que chega da internet. Veja como usar Zod para barrar dados inválidos na entrada da API e do formulário — com um único esquema.
- Ler artigo
Backend & APIs3 min
Versionamento de API: mudar sem quebrar o app de ninguém
Você muda um campo na API e o app antigo, ainda instalado em milhares de celulares, quebra. Veja como evoluir APIs sem derrubar ninguém.
- Ler artigo
Mobile3 min
App e site com a mesma base de código: o que compartilhar
React no site e React Native no app permitem compartilhar tipos, regras e lógica. Veja o que dá para reaproveitar e o que deve continuar separado.