Documentation Index Fetch the complete documentation index at: https://wiki.vivla.com/llms.txt
Use this file to discover all available pages before exploring further.
Estructura de Modulos La app sigue un patron module-first : cada feature tiene su propio modulo autocontenido en src/modules/, con una estructura interna consistente. El codigo compartido vive en src/shared/ y la configuracion central en src/core/.
Convencion de Estructura Interna Cada modulo puede contener los siguientes directorios (segun necesidad):
src/modules/<nombre>/ ├── api/ # Endpoints y llamadas HTTP ├── screens/ # Componentes de pantalla ├── components/ # Componentes del modulo ├── hooks/ # Hooks especificos del modulo ├── services/ # Logica de negocio ├── types/ # Tipos TypeScript ├── constants/ # Constantes ├── utils/ # Utilidades ├── store/ # Zustand store del modulo (si aplica) └── features/ # Sub-features (ej: booking/features/exchange)
No todos los modulos implementan todos los directorios. Cada modulo incluye solo lo que necesita,
manteniendo la estructura ligera.
Lista de Modulos Modulo Directorio Descripcion auth src/modules/auth/Autenticacion, login, registro, reset de contrasena, modo visitor/guest booking src/modules/booking/Reservas, intercambios, creacion de bookings, wallet. Incluye sub-feature features/exchange chat src/modules/chat/Mensajeria en tiempo real con Stream Chat. Gestion de canales, mensajes, invitaciones home src/modules/home/Pantalla principal, dashboard de propiedad, galeria, amenidades invitations src/modules/invitations/Gestion de invitaciones a propiedades por token y onboarding de invitados notifications src/modules/notifications/Gestion de notificaciones push y permisos profile src/modules/profile/Perfil de usuario, configuracion, roles (UserRole.GUEST, owner, etc.) property src/modules/property/Detalle de propiedades, seleccion de propiedad, reportes de calificacion stays src/modules/stays/Historial de estadias (activas, pasadas, canceladas, pendientes), reviews
Codigo Compartido (src/shared/) Componentes
Hooks
Servicios
Stores y Contexts
Ubicados en src/shared/components/, organizados por categoria: Directorio Contenido ui/Componentes base de UI (inputs, cards, badges, etc.) buttons/Botones reutilizables (BackButton, etc.) layout/Componentes de layout (Header, etc.) navigation/Componentes de navegacion feedback/Componentes de feedback (ProgressToastManager, etc.) icons/Iconos SVG custom (MyHome, Calendar, Stays, Profile, Inbox) onboarding/Componentes del flujo de onboarding
Ubicados en src/shared/hooks/: Hook Proposito useAppInitializationOrquesta la inicializacion de la app (auth, onboarding, splash screen) useNavigationLogica de navegacion basada en estado de auth y onboarding useLinkingManejo de deep links y URL schemes usePropertySelectionLogica de seleccion de propiedad y gate de navegacion useCombinedUnreadCountContador combinado de mensajes no leidos (Stream Chat) useAnalyticsProfileSyncSincronizacion de perfil con PostHog useAppLoadingStateEstado de carga global de la app useOnboardingStatusEstado del onboarding del usuario useKeyboardAwareScrollScroll ajustado al teclado useScrollVisibilityVisibilidad de elementos basada en posicion de scroll useStorageDiagnosticsDiagnosticos de almacenamiento (debug)
Ubicados en src/shared/services/: Servicio Descripcion api/client.tsCliente HTTP con Axios, interceptors, token refresh automatico api/errorHandler.tsClasificacion y manejo de errores de red storage/secureStorage.tsWrapper de expo-secure-store para datos sensibles queryInvalidationService.tsServicio de invalidacion de cache de React Query Linking Manejo de deep links Upload Servicio de subida de archivos
Stores (src/shared/stores/):
appStore - Estado de inicializaciononboardingStore - Estado de onboardingkeyboardStore - Altura del tecladopendingDeepLinkStore - Deep links pendientes Contexts (src/shared/contexts/):
BottomSheetContext - Gestion de bottom sheets con @gorhom/bottom-sheetScrollContext - Tracking de scroll offset y viewport Configuracion Central (src/core/)
analytics/ Cliente de PostHog (client.posthog.ts), definicion de eventos (events.ts) y punto de entrada
(index.ts).
config/ Variables de entorno (env/), configuracion de Sentry (sentry.ts), PostHog (posthog.ts),
deep linking (linking.ts), navegacion (navigation.ts).
featureFlags/ Feature flags centralizados (flags.ts). Ejemplo: financialReport2025.
Adicionalmente, src/core/i18n/ contiene la internacionalizacion con soporte para ingles (en.ts) y espanol (es.ts), ademas de localizacion de calendarios (calendarLocalization.ts).
Diagrama de Dependencias src/ ├── core/ # Configuracion central (sin dependencias de modules/) │ ├── analytics/ # PostHog │ ├── config/ # Env, Sentry, linking, navigation │ ├── featureFlags/ # Feature flags │ └── i18n/ # Internacionalizacion (es, en) │ ├── shared/ # Codigo compartido (puede depender de core/) │ ├── components/ # UI reutilizable │ ├── hooks/ # Hooks globales │ ├── stores/ # Zustand stores globales │ ├── services/ # API client, storage, upload │ ├── contexts/ # React Contexts │ ├── constants/ # Constantes (queryClient, navigation) │ ├── styles/ # Theme y estilos globales │ └── types/ # Tipos compartidos │ └── modules/ # Features (pueden depender de core/ y shared/) ├── auth/ ├── booking/ ├── chat/ ├── home/ ├── invitations/ ├── notifications/ ├── profile/ ├── property/ └── stays/
La regla de dependencia es unidireccional: modules/ puede importar de shared/ y core/, pero
shared/ no debe importar de modules/ y core/ no debe importar de shared/ ni modules/. La
excepcion es cuando se usa import dinamico (await import(...)) para evitar dependencias
circulares, como en authStore que importa chatStore de forma lazy.
