Skip to main content

​
Entorno de Desarrollo

Esta guia cubre todo lo necesario para configurar el entorno de desarrollo local de la app movil de Vivla.

​
Prerrequisitos

Antes de comenzar, asegurate de tener instaladas las siguientes herramientas:

Node.js 20+

Runtime de JavaScript. Se recomienda usar nvm para gestionar versiones.

npm

Gestor de paquetes incluido con Node.js.

EAS CLI >= 16.16.0

CLI de Expo Application Services para builds y updates.

Git + Husky

Control de versiones con pre-commit hooks configurados.

​
Plataformas

  • Xcode 15+ con Command Line Tools instaladas - Simulador de iOS configurado - CocoaPods (se instala automaticamente con npx pod-install)

​
Instalacion paso a paso

Segui estos pasos para configurar el proyecto desde cero:
Al ejecutar npm install, Husky se instala automaticamente a traves del script prepare definido en package.json. Esto configura los git hooks de pre-commit.
Despues de copiar el archivo de entorno, completa las variables necesarias en .env.development con los valores correspondientes a tu entorno local.

​
Variables de entorno

La siguiente tabla lista todas las variables de entorno requeridas. Obtene los valores de tu equipo o del gestor de secretos del proyecto.
Nunca incluyas valores reales de variables de entorno en el repositorio ni en documentacion publica.

​
Path aliases

El proyecto tiene configurados path aliases para simplificar los imports. Estos estan definidos en tsconfig.json y en la configuracion de Babel. Ejemplo de uso:

​
Herramientas de calidad de codigo

El proyecto utiliza varias herramientas para mantener la calidad del codigo:

​
ESLint + Prettier

  • ESLint para analisis estatico del codigo
  • Prettier para formateo automatico
  • lint-staged ejecuta ambos en pre-commit via Husky, aplicandose solo a los archivos modificados

​
TypeScript

  • Configurado en strict mode para maxima seguridad de tipos

​
Testing

  • Jest como framework de testing
  • @testing-library/react-native para tests de componentes

​
Scripts disponibles

Se recomienda ejecutar npm run validate antes de hacer push para asegurar que el codigo cumple con todos los estandares del proyecto.

​
Configuracion con Conductor

Si estas ejecutando el proyecto desde Conductor, el archivo bin/conductor-setup copia automaticamente los archivos .env necesarios. No es necesario configurar las variables de entorno manualmente en ese caso.