Moneta

Descrizione del progetto

Moneta è una mobile app di personal finance in sviluppo, costruita con Expo Router e React Native per portare in un’unica esperienza conti, movimenti, categorie, asset non finanziari e report di patrimonio netto. Il frontend è organizzato attorno a route group protetti: l’AuthProvider ripristina la sessione Supabase da expo-secure-store, poi l’app passa tra area auth e area privata senza gestire token manualmente nelle schermate. Le richieste passano da un client Axios centralizzato, configurato con base URL d’ambiente, timeout e request interceptor che allega il JWT Supabase quando esiste una sessione valida; sopra questo livello, TanStack Query definisce query key, cache, retry, invalidazioni e refetch per conti, transazioni, categorie, report e asset. La UI usa NativeWind con token warm/gold, componenti basati su RN Primitives, bottom sheet, skeleton state, error placeholder e pattern mobile-first per liste e azioni rapide. I form principali usano React Hook Form e Zod, con schema factory per messaggi tradotti e parsing degli importi in centesimi prima dell’invio alle API. A livello prodotto sono già avviati login/register, home con net worth, gestione conti, creazione e lettura transazioni, categorie personalizzabili, asset non finanziari e valutazioni; la tab budget è presente come superficie UI ma non è ancora collegata a dati reali. Per questo Moneta resta marcata come in sviluppo: l’obiettivo è un client mobile finance strutturato, tipizzato e pronto a crescere su contratti API reali.

Punti chiave del progetto

• Expo Router organizza l’app in route group auth/app, con schermate protette che dipendono dallo stato sessione e mantengono pulita la navigazione mobile.
• Supabase Auth è usato solo per autenticazione e sessione, con persistenza su SecureStore e JWT agganciato automaticamente alle chiamate API tramite interceptor Axios.
• TanStack Query centralizza server-state, query key, cache, refetch e invalidazioni per accounts, transactions, categories, reports e non-financial assets.
• React Hook Form + Zod gestiscono form complessi, validazione localizzata e trasformazioni robuste, come il parsing degli importi monetari in centesimi.
• NativeWind, RN Primitives e token di design custom definiscono un’interfaccia mobile warm/gold con skeleton, empty state, error state, liste finanziarie e flussi di creazione coerenti.