CyberPup

Un'app di cybersecurity gratuita e open-source per le persone comuni.

CyberPup aiuta gli utenti non tecnici a proteggere la loro vita digitale attraverso checklist guidate, lezioni brevi e strumenti come il controllo delle violazioni. Tutte le indicazioni si basano su framework noti di ACSC, CISA e NIST – tradotti in un linguaggio semplice che chiunque può effettivamente seguire.

La maggior parte degli strumenti di cybersecurity personale sono troppo tecnici, risolvono solo un pezzo del puzzle, o sono una vera e propria truffa. CyberPup cerca di guidare una persona attraverso il quadro completo: password, sicurezza email, igiene del dispositivo, social media e controllo delle violazioni.

L'app è disponibile sull'iOS App Store con circa 500 installazioni. Funziona, ma non è mantenuta attivamente. Questo repository è un invito aperto – a contributori, manutentori o chiunque voglia portarlo avanti.

Cosa fa

• Livelli di sicurezza progressivi - livelli Scout, Watchdog e Guardian che guidano gli utenti dalle basi all'avanzato
• Checklist interattive - azioni di sicurezza passo dopo passo con monitoraggio persistente dei progressi
• Guida specifica per piattaforma - istruzioni su misura per iOS, Android, macOS e Windows
• Controllo delle violazioni - integrazione con API stile HaveIBeenPwned per verificare se gli account sono compromessi
• Gamification - serie consecutive, badge e traguardi per mantenere gli utenti coinvolti
• Lezioni brevi - contenuti opzionali 'scopri di più' che non intralciano l'azione

Stack tecnologico

• React Native + Expo - mobile cross-platform (iOS e Android)
• React Navigation - navigazione tra schermate
• AsyncStorage - persistenza locale dei progressi
• PostHog - analisi attente alla privacy (con consenso dell'utente e possibilità di rinuncia)

L'opportunità dell'app web

Poiché è sviluppata in React Native con Expo, eseguirla come app web è una possibilità molto concreta - npm run web funziona già in sviluppo. Una corretta build web renderebbe CyberPup accessibile a chiunque senza bisogno di installare dall'App Store, ampliando notevolmente il pubblico per uno strumento pensato per persone non tecniche.

Questa è una delle cose di maggior impatto che un contributore potrebbe intraprendere.

Roadmap

Queste sono idee e cose rimaste nella lista delle cose da fare che non sono mai state realizzate. Sono qui per dare un'idea di dove il progetto potrebbe andare – non una specifica, solo un punto di partenza.

Messa a punto e correzioni

• Rendere l'informativa sulla privacy leggibile in linea invece di aprire un link
• Sezione aggiornamenti dispositivo: correggere la configurazione del retry bluetooth/wifi
• Schermata di caricamento/onboarding dell'app (esperienza del primo avvio)
• Supporto per la modalità chiara

Coinvolgimento

• Condividere i progressi quando si completa un livello di sicurezza
• Popup di conseguimento badge al completamento
• Notifiche push mensili di promemoria sulla sicurezza
• Espandere i contenuti nella scheda Insights

Nuovi strumenti

• Controllo della robustezza delle password con feedback in tempo reale
• Controllo dei link di phishing - analizzare URL sospetti
• Rilevamento di messaggi truffa per SMS ed email
• Integrazione API a pagamento HIBP per dati di violazione più ricchi (in attesa di valutazione dei prezzi)
• Guida alla rilevazione di chiamate/SMS truffa basata sul sistema operativo mobile

Idee più ampie

• App web (vedi sopra)
• CyberPup come personaggio/guida più prominente nell'app (animazioni sottili, personalità)
• Scanner delle impostazioni della privacy

Per iniziare

Prerequisiti

• Node.js 18+
• npm o yarn
• Expo Go sul telefono per test rapidi, o un simulatore/emulatore

Eseguilo in locale

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

Poi scansiona il codice QR con Expo Go, o premi i per il simulatore iOS / a per l'emulatore Android / w per il web.

Variabili d'ambiente

Crea un file .env.local nella root del progetto:

EXPO_PUBLIC_POSTHOG_API_KEY=your_key_here

L'analisi non eseguirà alcuna operazione in silenzio se la chiave è assente, quindi è opzionale per lo sviluppo locale.

Struttura del progetto

CyberPup/
├── App.js                    # Componente principale, configurazione navigazione
├── screens/
│   ├── WelcomeScreen.js      # Dashboard principale
│   ├── CategoryScreen.js     # Organizzazione dei controlli per livello
│   ├── ModuleListScreen.js   # Liste di controlli per area
│   ├── ProfileScreen.js      # Profilo utente e risultati
│   ├── StreakDetailsScreen.js
│   ├── BadgesScreen.js
│   └── lessons/              # Tutte le schermate dei singoli controlli
│       ├── level-1/
│       ├── level-2/
│       └── level-3/
├── components/               # Componenti UI riutilizzabili
├── data/                     # Dati dei contenuti e struttura dell'app
├── utils/                    # Logica di archiviazione, analisi, badge
├── theme.js                  # Sistema di design (colori, tipografia, spaziatura)
├── docs/                     # Guide all'architettura e allo sviluppo
└── assets/                   # Immagini e animazioni

Vedi docs/ per riferimenti sull'architettura, guide di sviluppo e note di implementazione.

Contribuire

I contributi sono benvenuti - correzioni di bug, nuovi controlli, miglioramenti dell'interfaccia, la build web o qualsiasi cosa dalla roadmap sopra.

Vedi CONTRIBUTING.md per come impostare e inviare modifiche.

Se sei interessato a ricoprire un ruolo più ampio (manutentore, portare il progetto in una nuova direzione), sentiti libero di aprire un issue o contattarmi direttamente.

Sito web

cyberpupsecurity.com

Licenza

MIT