react-native-architecture

Descripción general

¿Qué es react-native-architecture?

react-native-architecture ofrece un modelo práctico para construir aplicaciones móviles React Native escalables y listas para producción. Se centra en el uso de Expo, navegación avanzada, integración de módulos nativos, patrones offline-first y una estructura de proyecto sólida. Esta skill está diseñada para desarrolladores frontend y equipos móviles que buscan acelerar la entrega de apps siguiendo buenas prácticas.

¿Quién debería usar esta skill?

• Desarrolladores que inician proyectos nuevos con React Native o Expo
• Equipos que implementan flujos complejos de navegación o autenticación
• Proyectos que requieren integración con módulos nativos o APIs de plataforma
• Apps que necesitan soporte offline y gestión confiable del estado
• Cualquier persona que optimice el rendimiento de React Native o configure CI/CD para móvil

Problemas que resuelve

• Reduce el tiempo de configuración con una estructura de proyecto comprobada
• Aclara cuándo usar Expo o Bare React Native
• Guía la integración de módulos nativos y APIs de plataforma
• Soporta desarrollo offline-first y multiplataforma
• Ayuda a mantener bases de código escalables y mantenibles

Cómo usar

Pasos de instalación

1. Añade la skill a tu agente con:

   npx skills add https://github.com/wshobson/agents --skill react-native-architecture
   

2. Abre el archivo SKILL.md para una visión general y guía del flujo de trabajo.
3. Revisa archivos complementarios como README.md, AGENTS.md y metadata.json para contexto más profundo.
4. Explora los directorios rules/, resources/, references/ y scripts/ para detalles de implementación y utilidades.

Estructura recomendada del proyecto

Incluye:

• src/app/: pantallas con Expo Router, organizadas por tipo de navegación (ej. auth, tabs)
• src/components/: componentes UI y específicos de funcionalidades
• src/hooks/: hooks personalizados de React
• src/services/: integraciones con APIs y servicios nativos
• src/stores/: lógica de gestión de estado
• src/utils/: funciones utilitarias
• src/types/: definiciones de tipos TypeScript

Expo vs Bare React Native

• Expo: configuración más sencilla, módulos nativos gestionados, actualizaciones rápidas OTA
• Bare React Native: mayor control, enlace manual de módulos nativos, mayor complejidad
  Elige Expo para la mayoría de proyectos, salvo que necesites código nativo personalizado no soportado por Expo.

Adaptando la skill

En lugar de copiar archivos directamente, adapta la arquitectura y patrones para que encajen con tu repositorio, herramientas y convenciones de equipo.

Preguntas frecuentes

¿Cuál es el principal beneficio de react-native-architecture?

Ofrece un punto de partida claro y escalable para proyectos React Native, reduciendo tiempos de configuración y deuda técnica.

¿Puedo usar esto con proyectos React Native existentes?

Sí, puedes adoptar de forma incremental la estructura y patrones recomendados para mejorar la mantenibilidad.

¿Esta skill es solo para Expo?

No. Aunque se recomienda Expo para la mayoría de casos, la arquitectura también soporta Bare React Native cuando se requieren integraciones nativas personalizadas.

¿Por dónde empiezo después de la instalación?

Comienza con el archivo SKILL.md para una visión general, luego explora el árbol de archivos para guías detalladas y ejemplos.

¿Cómo veo todos los archivos y scripts disponibles?

Usa la pestaña Files para navegar el árbol completo, incluyendo referencias anidadas y scripts auxiliares.