Skip to content

JCGadeaDev/Boleteria

Repository files navigation

🎫 Boletería - Sistema de Gestión de Eventos

📝 Descripción

Sistema moderno de gestión de eventos desarrollado con React y Vite, que permite a los usuarios explorar eventos, marcar favoritos y gestionar su perfil personal.

Screenshot_7 Screenshot_1 Screenshot_2 Screenshot_3 Screenshot_6 Screenshot_4 Screenshot_8

🚀 Características Principales

  • 📋 Listado dinámico de eventos
  • ❤️ Sistema de eventos favoritos
  • 👤 Perfiles de usuario personalizados
  • 📱 Diseño responsive
  • 🔍 Vistas detalladas de eventos
  • 🛡️ Manejo de errores con Error Boundaries

🛠️ Tecnologías Utilizadas

  • Frontend: React
  • Build Tool: Vite
  • Estilos: Tailwind CSS
  • Optimización: React Suspense & Lazy Loading
  • Optimización: React Router DOM para navegación
  • Optimización: Zustand para manejo de estado
  • Optimización: React Hook Form para formularios
  • Optimización: React Paginate para paginación
  • Optimización: date-fns para manejo de fechas
  • Deployment: Vercel
  • Linting: ESLint
  • Otros: PostCSS

📦 Instalación

# Clonar el repositorio
git clone https://github.com/JCGadeaDev/Boleteria.git

# Instalar dependencias
npm install

# Crear archivo de variables de entorno
cp .env.example .env

# Iniciar en modo desarrollo
npm run dev

🔧 Configuración

Variables de Entorno Crear un archivo .env con las siguientes variables: VITE_API_URL=tu_url_api VITE_API_KEY=tu_api_key

📁 Estructura del Proyecto

src/
├── components/         # Componentes reutilizables
├── views/             # Vistas principales
├── hooks/             # Custom hooks
├── utils/             # Utilidades y helpers
├── state/            # Manejo de estado
└── assets/           # Recursos estáticos

🌟 Características Detalladas

Sistema de Eventos Visualización de eventos disponibles Filtrado y búsqueda Vista detallada de cada evento Gestión de Favoritos Marcado/desmarcado de eventos Persistencia de selecciones Sección de favoritos en perfil Perfil de Usuario Información personal Lista de eventos favoritos Preferencias de usuario

🔍 Hooks Personalizados

useEventsData: Gestión de datos de eventos useLikedEvents: Manejo de eventos favoritos

🚀 Despliegue

La aplicación está desplegada en Vercel y puede ser accedida en: https://boleteria-three.vercel.app/

📈 Optimizaciones

Implementación de React Suspense Lazy loading de componentes Optimización de imágenes Caching de datos

👨‍💻 Autor

JCGadeaDev