Guía de instalación y ejecución del proyecto - MVRU/Conectando-Corazones GitHub Wiki
📌 Índice de la guía
- Instalación de software requerido
- Configurar y ejecutar el backend
- Configurar y ejecutar el frontend
1. Instalación de software requerido
✅ 1.1 Instalar Visual Studio Code (opcional pero recomendado)
-
Descargar el instalador para Windows y ejecutarlo.
-
Recomendación: instalá las extensiones sugeridas:
- Prisma
- Error Lens
- Tailwind CSS IntelliSense
- GitHub Copilot (opcional)
✅ 1.2 Instalar Git
- Ingresá a https://git-scm.com/download/win
- Descargá el instalador para Windows.
- Ejecutá el archivo
.exe
y seguí los pasos por defecto (dejá las opciones como están).
✅ 1.3 Instalar Node.js (incluye npm)
- Ir a https://nodejs.org
- Descargar la versión LTS (recomendada) para Windows.
- Ejecutar el instalador y aceptar los valores por defecto.
Verificá la instalación abriendo una terminal (CMD o PowerShell):
node -v
npm -v
✅ 1.4 Clonar el repositorio
- Abrí la terminal o Git Bash.
- Ejecutá:
git clone https://github.com/MVRU/Conectando-Corazones.git
cd Conectando-Corazones
2. Configurar y ejecutar el backend
📁 Navegá a la carpeta
/backend
dentro del proyecto clonado.
cd backend
✅ 2.1 Instalar dependencias
npm install
Desde la terminal de Visual Studio Code con Git Bash.
.env
✅ 2.2 Crear y configurar el archivo - Copiá el archivo de ejemplo:
cp .env.example .env
- Completá los valores requeridos (si no los tenés, consultá al equipo).
⚠️ 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
.env
para frontend (si aplica)
✅ 3.2 Crear archivo - Copiá
.env.example
si está disponible:
cp .env.example .env
- 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