🏗️ Application Architecture - beatriznonato/rede-do-bem GitHub Wiki

The project architecture was designed to be modular, scalable and easy to maintain.

📁 Folder Structure

src/

├── assets/ # Imagens e ícones

├── components/ # Componentes reutilizáveis

├── hooks/ # Hooks personalizados

├── pages/ # Páginas principais da aplicação

├── services/ # Integração com Firebase e APIs externas

├── store/ # Contextos e estados globais

├── styles/ # Estilos globais

├── utils/ # Funções utilitárias

├── App.jsx

└── main.jsx

🔄 Data Flow

  • Context API for authentication and global state management
  • Firebase Auth for login and registration
  • Firestore for dynamic user data
  • Local storage for session persistence

💡 Best Practices

  • Clear separation between logic and UI
  • Use of custom hooks
  • Folders organized by domain responsibility
  • Accessible and responsive components

💻 Key Technologies

  • React 18 (with hooks)
  • Firebase (Auth, Firestore)
  • Progressive Web App (PWA) standards
  • OpenWeatherMap API for weather alerts
  • ViaCEP API for autofill of address information