A Gamified Masjid Attendance & Amal Tracker
MasjidGo is a Progressive Web App (PWA) designed to encourage and track mosque attendance through gamification. Earn XP, complete daily and weekly quests, climb the leaderboard, and explore masjid facilities — all from your phone.
| Feature | Description |
|---|---|
| 🎯 Quests | Complete daily and weekly Islamic challenges to earn XP |
| 📊 Leaderboard | Compete with fellow community members on weekly rankings |
| 📖 Quran Reader | Read the Quran with a built-in navigator and Arabic text |
| 🏛️ Facility Explorer | Browse masjid facilities with photo galleries |
| 👤 Profile & Streaks | Track your level, XP, and attendance streaks |
| 🌙 Dark Mode | Full dark mode support for comfortable reading |
MasjidGo works best when installed on your device as a Progressive Web App — no app store required.
- Open masjidgo.lovable.app in Safari
- Tap the Share button (⬆️) at the bottom of the screen
- Scroll down and tap "Add to Home Screen"
- Tap "Add" — the app icon will appear on your home screen
- Open masjidgo.lovable.app in Chrome
- Tap the ⋮ menu (top-right corner)
- Tap "Install app" or "Add to Home Screen"
- Confirm — the app will install and launch in standalone mode
- Visit masjidgo.lovable.app
- Click the install icon (⊕) in the address bar
- Click "Install"
Once installed, MasjidGo runs in standalone mode with offline caching support, giving you a native app experience.
- React + TypeScript — UI framework
- Vite — Build tool with HMR
- Tailwind CSS — Utility-first styling
- shadcn/ui — Accessible component library
- Supabase — Authentication, database & edge functions
- vite-plugin-pwa — Service worker & manifest generation
- Framer Motion — Scroll animations
# Clone the repository
git clone <YOUR_GIT_URL>
cd masjidgo
# Install dependencies
npm install
# Start development server
npm run devThe app runs at http://localhost:8080 by default.
This project is built and maintained with Lovable.