CyberPup

Una aplicación de ciberseguridad gratuita y de código abierto para personas comunes.

CyberPup ayuda a usuarios no técnicos a proteger su vida digital mediante listas de verificación guiadas, lecciones breves y herramientas como la verificación de filtraciones. Toda la orientación se basa en marcos reconocidos de ACSC, CISA y NIST, traducidos a un lenguaje sencillo que cualquiera puede seguir.

La mayoría de las herramientas personales de ciberseguridad son demasiado técnicas, solo resuelven una parte del problema o son una completa estafa. CyberPup intenta guiar a alguien a través del panorama completo: contraseñas, seguridad del correo electrónico, higiene de dispositivos, redes sociales y verificación de filtraciones.

La aplicación está disponible en la App Store de iOS con aproximadamente 500 instalaciones. Funciona, pero no se mantiene activamente. Este repositorio es una invitación abierta para colaboradores, mantenedores o cualquier persona que quiera llevarlo más allá.

---

Qué hace

• Niveles de seguridad progresivos - Categorías Scout, Watchdog y Guardian que guían a los usuarios desde lo básico hasta lo avanzado
• Listas de verificación interactivas - acciones de seguridad paso a paso con seguimiento persistente del progreso
• Orientación específica por plataforma - instrucciones adaptadas para iOS, Android, macOS y Windows
• Verificación de filtraciones - integración con APIs estilo HaveIBeenPwned para comprobar si las cuentas están comprometidas
• Gamificación - rachas, insignias e hitos de logros para mantener a los usuarios interesados
• Lecciones breves - contenido opcional de "aprender más" que no interfiere con la acción

---

Tecnología utilizada

• React Native + Expo - multiplataforma móvil (iOS y Android)
• React Navigation - navegación entre pantallas
• AsyncStorage - persistencia local del progreso
• PostHog - analítica respetuosa con la privacidad (con consentimiento del usuario y posibilidad de exclusión)

---

La oportunidad de la aplicación web

Debido a que está construido en React Native con Expo, ejecutarlo como aplicación web es una posibilidad muy real - npm run web ya funciona en desarrollo. Una compilación web adecuada haría que CyberPup sea accesible para cualquier persona sin necesidad de instalar desde una tienda de aplicaciones, lo que amplía drásticamente la audiencia para una herramienta dirigida a personas no técnicas.

Esta es una de las tareas de mayor impacto que un colaborador podría asumir.

---

Hoja de ruta

Estas son ideas y tareas pendientes que nunca se llegaron a construir. Están aquí para dar una idea de hacia dónde podría ir el proyecto, no son una especificación, solo un punto de partida.

Pulido y correcciones

• Hacer que la política de privacidad sea legible en línea en lugar de abrir un enlace
• Sección de actualizaciones de dispositivos: corregir la configuración de reintento de bluetooth/wifi
• Pantalla de carga/incorporación de la aplicación (experiencia del primer inicio)
• Soporte de modo claro

Participación

• Compartir progreso al completar un nivel de seguridad
• Ventana emergente de logro de insignia al completar
• Notificaciones push mensuales de recordatorio de seguridad
• Expandir contenido en la pestaña Insights

Nuevas herramientas

• Comprobador de fortaleza de contraseñas con retroalimentación en tiempo real
• Comprobador de enlaces de phishing - analizar URL sospechosas
• Detección de mensajes de estafa para textos y correos electrónicos
• Integración de la API paga de HIBP para datos de filtraciones más ricos (pendiente de viabilidad de precios)
• Orientación sobre detección de llamadas/SMS fraudulentos según el sistema operativo móvil

Ideas más grandes

• Aplicación web (ver arriba)
• CyberPup como personaje/guía más destacado dentro de la aplicación (animaciones sutiles, personalidad)
• Escáner de configuraciones de privacidad

---

Primeros pasos

Requisitos previos

• Node.js 18+
• npm o yarn
• Expo Go en tu teléfono para pruebas rápidas, o un simulador/emulador

Ejecutar localmente

git clone https://github.com/brodsbytes/cyberpup.git
cd cyberpup
npm install
npm start

Luego escanea el código QR con Expo Go, o presiona i para el simulador de iOS / a para el emulador de Android / w para web.

Variables de entorno

Crea un archivo .env.local en la raíz del proyecto:

EXPO_PUBLIC_POSTHOG_API_KEY=your_key_here

La analítica se silenciará si la clave está ausente, por lo que esto es opcional para el desarrollo local.

---

Estructura del proyecto

CyberPup/
├── App.js                    # Componente raíz, configuración de navegación
├── screens/
│   ├── WelcomeScreen.js      # Panel principal
│   ├── CategoryScreen.js     # Organización de verificaciones por nivel
│   ├── ModuleListScreen.js   # Listas de verificación por área
│   ├── ProfileScreen.js      # Perfil de usuario y logros
│   ├── StreakDetailsScreen.js
│   ├── BadgesScreen.js
│   └── lessons/              # Todas las pantallas de verificación individuales
│       ├── level-1/
│       ├── level-2/
│       └── level-3/
├── components/               # Componentes de UI reutilizables
├── data/                     # Datos de contenido y estructura de la aplicación
├── utils/                    # Lógica de almacenamiento, analítica e insignias
├── theme.js                  # Sistema de diseño (colores, tipografía, espaciado)
├── docs/                     # Guías de arquitectura y desarrollo
└── assets/                   # Imágenes y animaciones

Consulta docs/ para referencias de arquitectura, guías de desarrollo y notas de implementación.

---

Contribuir

Las contribuciones son bienvenidas: corrección de errores, nuevas verificaciones, mejoras de UI, la compilación web o cualquier cosa de la hoja de ruta anterior.

Consulta CONTRIBUTING.md para saber cómo configurar y enviar cambios.

Si estás interesado en asumir un rol más grande (mantenedor, llevar el proyecto en una nueva dirección), no dudes en abrir un issue o contactar directamente.

---

Sitio web

cyberpupsecurity.com

---

Licencia

MIT