Waryaahe/tsp-app

Prayer times app for Somali diaapora # TSH - Prayer Times, Mosques & Fasting App **TSH** is a community-driven prayer times and mosque finder app for Somali Muslims in the diaspora and Somalia. ## Features (MVP) ✅ **Prayer Times** - Real-time prayer times with offline caching (30 days) ✅ **Find Mosques** - Discover nearby mosques using Google Places ✅ **Fasting Guide** - Ramadan calendar and fasting information ✅ **Hajj Guide** - Step-by-step hajj pilgrimage guide ✅ **Offline First** - Works without internet; caches data locally ✅ **Multilingual** - Somali and English support ## Tech Stack - **React Native + Expo** - Cross-platform mobile (iOS/Android) - **Firebase** - Firestore backend + user preferences storage - **Aladhan API** - Prayer times calculation - **Google Places API** - Mosque location finder - **AsyncStorage** - Local caching for offline support ## Getting Started ### 1. Install Node.js Download from nodejs.org (LTS version) Verify installation: ```bash node --version # Should show v18+ or higher npm --version # Should show 8.0+ ``` ### 2. Clone or Download the Project ```bash cd tsh-app ``` ### 3. Install Dependencies ```bash npm install ``` This installs all React Native packages, Expo, and APIs. ### 4. Set Up Environment Variables Copy `.env.example` to `.env`: ```bash cp .env.example .env ``` Then edit `.env` and add your API keys: **Firebase Setup:** 1. Go to firebase.google.com 2. Create a new project 3. Get your Firebase config from Project Settings 4. Add to `.env` **Google Places API:** 1. Go to console.cloud.google.com 2. Enable "Places API" 3. Create an API key 4. Add to `.env` **Aladhan API:** - No key needed (free tier) ### 5. Start the App ```bash npm start ``` This launches Expo Metro bundler. You'll see: ``` expo start > Metro waiting on exp://localhost:19000 ``` ### 6. Run on Device or Emulator **On Your Phone (Recommended):** - Download Expo Go app (iOS App Store or Google Play) - Scan the QR code shown in terminal - …