Bárbara Nunes
Bárbara Nunes08/08/2025 15:38
Compartilhe

Nunca esqueça de buildar o TypeScript antes do deploy

  • #Node.js
  • #TypeScript
  • #JavaScript

Nunca esqueça de buildar o TypeScript antes do deploy

🕒 Lição aprendida às 3 da manhã… e só resolvida no dia seguinte 😮‍💨

Essa vai pra mim mesma (e pra quem precisar):

Passei horas de madrugada, até 3h da manhã, tentando subir uma API feita em TypeScript.

Testei rota por rota, conferi o servidor, mexi em tudo quanto era arquivo… e nada do deploy funcionar.

Frustrada, larguei tudo e fui dormir.

no outro dia, depois de recomeçar o projeto do zero, percebi o erro:

Eu não tinha rodado o build do TypeScript. 😭

Ou seja: a API rodava perfeitamente localmente, mas o ambiente de produção não reconhece arquivos .ts. Sem os .js, o Node não consegue executar nada.

✅ O que fazer sempre antes do deploy com TypeScript

  1. Rodar o build:
bash

npx tsc
  1. Verificar se os arquivos .js foram gerados corretamente (geralmente na pasta dist/, build/ ou configurada no tsconfig.json).
  2. Subir apenas os arquivos prontos pro servidor (ou configurar o ambiente de produção para rodar o build antes de iniciar).

💡 Dica extra: automatize com package.json

json

"scripts": {
"build": "tsc",
"start": "node dist/index.js"
}

Assim, é só rodar:

bash

npm run build
npm start

🧠 Moral da história:

NUNCA suba um projeto TypeScript sem buildar antes.

Isso evita:

  • Deploys fantasmas;
  • Erros estranhos que “não acontecem localmente”;
  • Horas de frustração;
  • E noites mal dormidas 😴.
Builda antes. Dorme depois. 😅
Compartilhe
Comentários (3)
Islânia Silva
Islânia Silva - 10/08/2025 18:36

Obrigada pelo artigo de grande valor.

Belisnalva Jesus
Belisnalva Jesus - 08/08/2025 22:45

Parabéns pelo artigo Bárbara! Já quebrei muito a minha cabeça, foi tanto que não queria mexer mais no TypeScript.

DIO Community
DIO Community - 08/08/2025 17:28

Bárbara, impossível não se identificar com esse relato! Seu post é mais que um alerta técnico, é um lembrete humano, real e valioso sobre as armadilhas que pegam até os devs mais cuidadosos. O jeito leve como você compartilhou esse aprendizado transforma um erro comum em um insight coletivo para quem desenvolve com TypeScript.

Na DIO, a gente sempre reforça a importância de entender o ciclo de vida da aplicação e sua história é um ótimo exemplo de como um detalhe como o npx tsc pode ser a diferença entre deploy e desespero.

Na sua visão, qual outra “lição de produção” já te salvou depois de uma madrugada difícil como essa?