Skip to content

Instantly share code, notes, and snippets.

@elkake
Forked from Klerith/pasos-node-typescript.md
Last active September 25, 2025 18:59
Show Gist options
  • Select an option

  • Save elkake/d3e9075a9289411aabf54c57f905c0f3 to your computer and use it in GitHub Desktop.

Select an option

Save elkake/d3e9075a9289411aabf54c57f905c0f3 to your computer and use it in GitHub Desktop.
Configurar proyecto de Node con TypeScript

Pasos para usar Node con TypeScript con Nodemon

Más información - Docs Oficiales

  1. Instalar TypeScript y tipos de Node, como dependencia de desarrollo
npm i -D typescript @types/node
  1. Inicializar el archivo de configuración de TypeScript ( Se puede configurar al gusto) inicia el tsc, creando el tsconfing , marca como salida la carpeta dist y observa como root el src
npx tsc --init --outDir dist/ --rootDir src

NOTA: agregar types en el archivo tsconfig con ['node','jest']

  1. Opcional - Para traspilar el código, se puede usar este comando
npx tsc
npx tsc --watch
  1. Configurar Nodemon y Node-TS, tsx (tsx tiene la version watch "tsx watch src") permite ejecutar ts en node
npm install -D tsx nodemon
  1. Crear archivo de configuración de Nodemon - nodemon.json
{
  "watch": ["src"],
  "ext": ".ts,.js",
  "ignore": ["node_modules"],
  "exec": "tsx ./src/app.ts"
}
  1. Crear script para correr en desarrollo en el package.json
  "dev": "nodemon"
  "dev": "npx nodemon" // En caso de no querer instalar nodemon
  1. Instalar rimraf (Herramienta que funciona similar al rm -f) eliminar directorio
npm install -D rimraf
  1. Crear scripts en el package.json para construir e iniciar en producción
   "build": "rimraf ./dist && tsc",
   "start": "npm run build && node dist/app.js"
  1. Configurar src como base del proyecto al importar (@) tsconfig:
  "baseUrl": "./",                                
  "paths": { "@/*": ["src/*"]}, 
  1. OPCIONAL, si se trabaja con jest, excluir el jest.config de tsconfig (a nivel de compilerOptions):
   "exclude": ["jest.config.ts", "node_modules","tests"]

Node con TypeScript - Recomendado

  1. Instalar TypeScript y demás dependencias
npm i -D typescript @types/node ts-node nodemon rimraf
  1. Inicializar el archivo de configuración de TypeScript ( Se puede configurar al gusto)
npx tsc --init --outDir dist/ --rootDir src
  1. Crear archivo de configuración Nodemon - nodemon.json
{
  "watch": ["src"],
  "ext": ".ts,.js",
  "ignore": [],
  "exec": "npx ts-node ./src/app.ts"
}
  1. Crear scripts para dev, build y start
  "dev": "nodemon",
  "build": "rimraf ./dist && tsc",
  "start": "npm run build && node dist/app.js"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment