Guía de instalación y ejecución del proyecto - MVRU/Conectando-Corazones GitHub Wiki

📌 Índice de la guía

  1. Instalación de software requerido
  2. Configurar y ejecutar el backend
  3. Configurar y ejecutar el frontend

1. Instalación de software requerido

✅ 1.1 Instalar Visual Studio Code (opcional pero recomendado)

  1. Ir a https://code.visualstudio.com/

  2. Descargar el instalador para Windows y ejecutarlo.

  3. Recomendación: instalá las extensiones sugeridas:

    • Prisma
    • Error Lens
    • Tailwind CSS IntelliSense
    • GitHub Copilot (opcional)

✅ 1.2 Instalar Git

  1. Ingresá a https://git-scm.com/download/win
  2. Descargá el instalador para Windows.
  3. Ejecutá el archivo .exe y seguí los pasos por defecto (dejá las opciones como están).

Screenshot 2025-05-19 185858 Screenshot 2025-05-19 190009


✅ 1.3 Instalar Node.js (incluye npm)

  1. Ir a https://nodejs.org
  2. Descargar la versión LTS (recomendada) para Windows.
  3. Ejecutar el instalador y aceptar los valores por defecto.

Verificá la instalación abriendo una terminal (CMD o PowerShell):

node -v
npm -v

install-node


✅ 1.4 Clonar el repositorio

  1. Abrí la terminal o Git Bash.
  2. Ejecutá:
git clone https://github.com/MVRU/Conectando-Corazones.git
cd Conectando-Corazones

arbol-de-carpetas


2. Configurar y ejecutar el backend

📁 Navegá a la carpeta /backend dentro del proyecto clonado.

cd backend

✅ 2.1 Instalar dependencias

npm install

Screenshot 2025-05-19 190424

Desde la terminal de Visual Studio Code con Git Bash.


✅ 2.2 Crear y configurar el archivo .env

  1. Copiá el archivo de ejemplo:
cp .env.example .env
  1. Completá los valores requeridos (si no los tenés, consultá al equipo).

Ejemplo de archivo .env

⚠️ Las variables de entorno contienen datos sensibles que no deben compartise públicamente.


✅ 2.3 Ejecutar el backend en modo desarrollo

npm run dev

✔️ El servidor se inicia en http://localhost:3000


3. Configurar y ejecutar el frontend

📁 Navegá a la carpeta /frontend dentro del proyecto.

cd ../frontend

✅ 3.1 Instalar dependencias

npm install

✅ 3.2 Crear archivo .env para frontend (si aplica)

  1. Copiá .env.example si está disponible:
cp .env.example .env
  1. Configurá la URL del backend (por ejemplo):
VITE_API_URL=http://localhost:3000

✅ 3.3 Ejecutar el frontend

npm run dev

✔️ La aplicación se iniciará en http://localhost:5173