ZeeJew16/madam-app

A mobile app for South African women with mood tracking and emergency support # 👩 Madam - Your Pocket Sister A compassionate mobile app built for South African women, providing mood tracking, emergency support, and wellness resources. ## 🌟 Features - **👤 Authentication**: Secure signup and login with Firebase - **📊 Mood Tracking**: Log your emotions and track patterns over time - **🆘 Emergency SOS**: Quick access to emergency contacts and resources - **⚙️ Settings**: Manage account, subscription, and privacy - **📱 Mobile-First**: Optimized for mobile devices with bottom navigation ## ��️ Tech Stack - **Frontend**: React 18 + Vite - **Styling**: Tailwind CSS - **Backend**: Firebase (Auth, Firestore) - **Payments**: Stripe - **SMS**: Twilio (for SOS alerts) ## 📋 Project Structure ``` src/ ├── pages/ │ ├── Login.jsx # Authentication │ ├── Signup.jsx # Registration │ ├── Dashboard.jsx # Home page with mood overview │ ├── Mood.jsx # Mood logging interface │ ├── SOS.jsx # Emergency resources & SOS │ └── Settings.jsx # Account & app settings ├── components/ │ ├── Layout/ │ │ ├── Navbar.jsx # Top navigation │ │ └── BottomNav.jsx # Bottom tab navigation │ ├── EmptyState.jsx # Empty state UI │ ├── SkeletonCard.jsx # Loading skeleton │ └── SkeletonEventCard.jsx ├── App.jsx # Router & Protected routes ├── main.jsx # React entry point ├── index.css # Global styles └── firebaseConfig.js # Firebase setup ``` ## 🚀 Getting Started ### Prerequisites - Node.js 16+ - Firebase account - Stripe account (for payments) ### Installation 1. **Clone the repository** ```bash git clone github.com cd madam-app ``` 2. **Install dependencies** ```bash npm install ``` 3. **Set up environment variables** ```bash cp .env.example .env.local ``` Then add your Firebase credentials to `.env.local`: ``` VITE_FIREBASE_API_KEY=your_key VITE_FIREBASE_AUTH_DOMAIN=your_domain VITE_FIREBASE_PROJEC …