Cómo armar un proyecto de Electron con Vite, React y TypeScript

Empezar un proyecto de Electron con Vite, React y TypeScript desde cero sirve para aprender, pero en un proyecto real pierdes mucho tiempo configurando cosas: compilar TypeScript, recargar la ventana cuando cambias código, separar los procesos, preparar el empaquetado. Una buena plantilla te ahorra todo eso.

Hoy hay una plantilla muy cómoda que se llama electron-vite. Une Electron con Vite, así que tienes recarga en vivo, TypeScript listo y React configurado desde el primer comando. Además trae electron-builder para generar los instaladores cuando termines.

En este artículo la creamos, revisamos las carpetas y vemos cómo se trabaja con ella día a día.

Crear el proyecto de Electron con Vite, React y TypeScript

Necesitas Node.js instalado. Abre una terminal y corre:

npm create @quick-start/electron@latest mi-app

El asistente te hace unas preguntas. Elige estas respuestas:

  • Framework: React
  • TypeScript: sí
  • ESLint y Prettier: sí, te ayudan a mantener el código ordenado

Cuando termine, entra a la carpeta e instala las dependencias:

cd mi-app
npm install
npm run dev

Se abre una ventana con la app de ejemplo. Si cambias algo en un archivo de React, la ventana se actualiza sola, sin que cierres y abras nada.

Cómo se organizan las carpetas

Dentro de src hay tres carpetas, una por cada parte de la app:

src/
  main/       -> proceso principal (crea ventanas, habla con el sistema)
  preload/    -> puente seguro entre el principal y la página
  renderer/   -> tu interfaz en React

En src/main/index.ts vive el código que crea la ventana. Aquí también vas a poner todo lo que toque archivos, bases de datos o impresoras. En src/renderer/src tienes tu app de React, igual que en cualquier proyecto web. Y src/preload/index.ts es el lugar donde decides qué funciones del proceso principal puede usar la interfaz. Eso lo vemos a fondo en los artículos de IPC y de contextBridge.

Los comandos que más vas a usar

En el package.json encuentras estos scripts:

  • npm run dev: abre la app en modo desarrollo con recarga en vivo.
  • npm run typecheck: revisa los errores de TypeScript sin ejecutar nada.
  • npm run build: compila el código de los tres procesos.
  • npm run build:win, build:mac y build:linux: generan el instalador para cada sistema.

Ojo con los instaladores: el de macOS solo se genera desde una Mac. Windows y Linux funcionan mejor desde su propio sistema, y más adelante veremos cómo automatizar esto.

Un primer cambio para probarlo

Abre src/renderer/src/App.tsx y cambia el texto que aparece en pantalla. Guarda el archivo. En un segundo, la ventana muestra el cambio. Ahora abre src/main/index.ts y cambia el tamaño de la ventana (width y height). Esta vez, al guardar, la app se reinicia sola, porque el proceso principal no se puede recargar en caliente como la interfaz.

Cosas que conviene hacer desde el inicio

Antes de escribir tu primera pantalla, revisa tres cosas:

  1. Cambia el nombre y el id de la app en package.json y en electron-builder.yml. Si lo dejas con los valores de ejemplo, los instaladores salen con ese nombre.
  2. Cambia los íconos de la carpeta build y resources.
  3. Deja contextIsolation activo y no habilites nodeIntegration. La plantilla ya viene así, no lo desactives para salir del paso.

Con esto ya tienes una base seria para trabajar. En el siguiente artículo vemos cómo se comunican el proceso principal y la interfaz, que es el tema donde más se atoran quienes empiezan.

Dejar un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *