Access Code App

Esta aplicación móvil desarrollada con React Native y Expo permite la gestión de accesos para residenciales mediante códigos QR.

Características principales

• Sistema de login para usuarios (residentes, guardias y administradores)
• Generación de códigos QR para visitas
• Escaneo y validación de códigos QR
• Gestión de anuncios para la comunidad
• Historial de accesos
• Creación de nuevos usuarios

Requisitos previos

• Node.js 16 o superior
• npm o yarn
• Cuenta de Expo
• Expo Go app (para pruebas en dispositivo físico)

Configuración del proyecto

1. Clonar el repositorio

git clone <url-del-repositorio>
cd access-code

2. Instalar las dependencias

npm install

3. Configurar Firebase

Edita el archivo firebaseConfig.ts y reemplaza los valores de configuración con los de tu proyecto en Firebase:

const firebaseConfig = {
    apiKey: "<TU_API_KEY>",
    authDomain: "<TU_AUTH_DOMAIN>",
    projectId: "<TU_PROJECT_ID>",
    storageBucket: "<TU_STORAGE_BUCKET>",
    messagingSenderId: "<TU_MESSAGING_SENDER_ID>",
    appId: "<TU_APP_ID>",
};

Ejecución del proyecto en desarrollo

Ejecutar en modo desarrollo

npx expo start

Este comando inicia el servidor de desarrollo de Expo. Puedes entonces:

• Presionar a para abrir en un emulador de Android
• Presionar i para abrir en un simulador de iOS
• Escanear el código QR con la app Expo Go en tu dispositivo

Ejecutar en desarrollo con cliente de desarrollo

npx expo start --dev-client

Creación de builds con Expo EAS

Expo Application Services (EAS) es la plataforma recomendada para crear builds de aplicaciones Expo.

Configuración inicial de EAS

1. Instalar EAS CLI globalmente:

npm install -g eas-cli

2. Iniciar sesión en tu cuenta de Expo:

eas login

3. Configurar el proyecto (ya realizado en este proyecto, ver eas.json):

eas build:configure

Crear diferentes tipos de builds

Build de desarrollo

Para crear un build de desarrollo que se puede instalar en dispositivos y contiene herramientas de desarrollo:

eas build --profile development --platform android

O para iOS:

eas build --profile development --platform ios

Build de preview (internal testing)

Para crear un build de vista previa para pruebas internas:

eas build --profile preview --platform android

Para iOS:

eas build --profile preview --platform ios

Build de producción

Para crear un build final para la tienda:

eas build --profile production --platform android

Para iOS:

eas build --profile production --platform ios

Enviar a tiendas de aplicaciones

Para enviar la aplicación a Google Play Store o Apple App Store:

eas submit --platform android
eas submit --platform ios

Estructura del proyecto

• /app: Contiene las pantallas de la aplicación (enrutamiento basado en archivos con Expo Router)
• /components: Componentes reutilizables
• /context: Contextos de React, incluido el contexto de autenticación
• /services: Servicios para interactuar con Firebase
• /assets: Imágenes, fuentes y otros recursos estáticos

Notas importantes

• Asegúrate de tener una cuenta de Expo para realizar builds con EAS
• Para builds de iOS necesitarás una cuenta de Apple Developer
• Para builds de Android para tienda necesitarás una cuenta de Google Play Developer
• El archivo eas.json ya está configurado con perfiles para diferentes tipos de builds

Recursos adicionales

• Documentación de Expo
• Documentación de Expo Router
• Documentación de Expo EAS
• Documentación de Firebase