# πΊ Makari Islamic TV
A complete, production-ready Islamic streaming platform dedicated to the lectures, tafsir, and teachings of **Malam Ibrahim Makari**.
---
## β¨ Features
| Feature | Status |
|---|---|
| Splash Screen + Onboarding | β
|
| Home Page (Featured, Trending, Live, Categories) | β
|
| Tafsir Section | β
|
| Audio Player (Stream, Download, Speed, Sleep Timer) | β
|
| Video Player (YouTube embed + Direct stream) | β
|
| Live Streaming | β
|
| 10 Content Categories | β
|
| Full-text Search | β
|
| Favorites System | β
|
| Downloads (offline) | β
|
| Push Notifications | β
|
| Islamic Library (Books/PDFs) | β
|
| Prayer Times (GPS-based) | β
|
| Qibla Direction Compass | β
|
| User Authentication (Register/Login) | β
|
| Admin Dashboard | β
|
| Dark Mode + Light Mode | β
|
| Hausa + English Language | β
|
| Mobile-first Responsive Design | β
|
| Skeleton Loaders + Shimmer Effects | β
|
---
## π οΈ Tech Stack
- **Frontend:** HTML5, CSS3, Vanilla JavaScript (Mobile-first PWA)
- **Backend:** Python FastAPI
- **Database:** SQLite (dev) / PostgreSQL (production)
- **Auth:** JWT (python-jose + bcrypt)
- **Media:** Static file serving + YouTube embed + Direct stream
- **Deployment:** Render / Railway
---
## π Quick Start
### 1. Backend Setup
```bash
cd backend
# Install dependencies
pip install -r requirements.txt
# Copy env file
cp .env.example .env
# Seed database with demo content
python seed.py
# Run the server
uvicorn main:app --reload --port 8000
```
API will be live at: `
localhost`
API Docs: `
localhost`
### 2. Frontend
Simply open `frontend/index.html` in a browser, or serve it:
```bash
cd frontend
python -m http.server 3000
# Open
localhost
```
The frontend auto-detects the API at `localhost:8000` in development.
---
## π Default Admin Account
```
Email: admin@makariilamictv.com
Password: admin123
```
> β οΈ Change this immediately in production!
---
## π Project Structure
```
makari-islami β¦