Si estás arrancando un proyecto nuevo o querés mejorar uno que ya tenés andando, te voy a decir algo rápido: usar TypeScript te va a ahorrar quilombos. No es magia, no es elitismo, no es “soy mejor programador porque uso TS”.
Es simplemente una herramienta que te evita romper cosas por errores previsibles.

En este artículo te cuento cómo implementar TypeScript, pero con cero humo y desde la experiencia real de alguien que lo usa todos los días en React, Next.js y librerías internas.

Por qué empecé a usar TypeScript (y por qué no lo dejo más)

La verdad: empecé a usar TS porque ya estaba cansado de romper cosas por detalles boludos. Variables mal escritas, funciones que devolvían cualquier cosa, props mal pasadas… esas cosas que en JavaScript pasan desapercibidas hasta que explotás todo.

Con TypeScript:

• el editor te avisa antes,
• tu código queda más ordenado,
• y la mitad de los bugs nunca llegan a producción.

Literalmente te hace pensar antes de escribir.

Cómo agregar TypeScript a un proyecto (paso simple y real)

Si tenés un proyecto JS y querés pasar a TS, es así:

1. Instalás TypeScript (en mi caso uso pnpm, pero podes usar el que mas te guste):

1pnpm install - typescript @types/node

2. Ejecutás:

1pnpx tsc --init

Esto te genera un tsconfig.json, que es básicamente el archivo donde TS decide qué tan estricto querés ser.

3. Renombrás archivos:

• *.js → *.ts
• *.jsx → *.tsx

No hay más ciencia que esa.

Configuraciones recomendadas (las que uso SIEMPRE)

Dentro del tsconfig.json hay mil opciones, pero estas son las que realmente importan:

1{
2  "strict": true,
3  "baseUrl": ".",
4  "paths": {
5    "@/*": ["src/*"]
6  }
7}

• strict: te obliga a pensar un poco, pero te salva la vida.
• baseUrl y paths: importás bonito, sin rutas kilométricas.

Primeros pasos con tipos (lo básico que realmente usás)

Acá no te voy a vender teoría. Esto es lo que realmente necesitás para empezar:

Tipos simples:

1let name: string;
2let age: number;
3let isActive: boolean;

Tipar props de un componente:

1type ButtonProps = {
2  label: string;
3  onClick?: () => void;
4};
5
6export function Button({ label, onClick }: ButtonProps) {
7  return <button onClick={onClick}>{label}</button>;
8}

Listo. Ya estás usando TS.

Errores comunes cuando migrás a TypeScript (para que no hagas lo mismo que yo)

• Abusar de any
  Es tentador. No lo hagas.
  Si algo te obliga a usar any, probablemente la estructura no está tan clara.
• No tipar los retornos de las funciones
  Te ahorras dolores de cabeza.
• Dejar los archivos como .js en vez de .ts
  Sí, me pasó. No seas yo.
• No aprovechar Record<T,K>
  Es literalmente una de las herramientas más útiles si te gusta mapear cosas y no usar switch (como yo).

TypeScript no te hace mejor, pero sí te hace más prolijo

Usar TypeScript no es un requisito para ser buen programador.
Pero te da algo clave: confianza en tu propio código.
Te ahorra errores estúpidos, te ordena la cabeza y te obliga a pensar un poquito más antes de romper todo.

Si querés subir el nivel de tus proyectos, TS es uno de esos cambios que no tienen contra.

Cierro con esto

Si estás dudando en migrar a TypeScript, te lo digo así:
Hacelo. Es de esos cambios que te devuelven el doble de lo que te piden.

Y si te trabás, no es porque TypeScript sea difícil.
Es porque tu JavaScript probablemente tenía desordenes que TS ahora te está mostrando.

Eso es bueno.