Merge remote-tracking branch 'origin/feat/learn-module'
This commit is contained in:
Antigravity AI
@@ -40,3 +40,7 @@ yarn-error.log*
|
||||
*.tsbuildinfo
|
||||
next-env.d.ts
|
||||
.gstack/
|
||||
|
||||
# generated TTS audio (large binary files — run scripts/generate-tts-local.js locally)
|
||||
public/audio/learn/**/*.m4a
|
||||
public/audio/learn/**/*.wav
|
||||
|
||||
@@ -0,0 +1,143 @@
|
||||
# 🤝 Pi ↔ Hermes Collaboration Protocol
|
||||
|
||||
> **Status:** ACTIVE — Hermes connected via `herdr --remote` (client_id=4)
|
||||
> **Workspace:** `w1` (mac-mini-1, 192.168.0.10)
|
||||
> **Hermes Origin:** MacBook Air (192.168.0.8, Tailscale 100.76.3.26)
|
||||
|
||||
---
|
||||
|
||||
## How We're Connected
|
||||
|
||||
```
|
||||
Hermes (MacBook Air, 192.168.0.8)
|
||||
│ SSH → 192.168.0.10:22
|
||||
│ herdr --remote mac-mini-1
|
||||
▼
|
||||
herdr server (mac-mini-1, 192.168.0.10)
|
||||
│ Unix socket: ~/.config/herdr/herdr.sock
|
||||
│ Client ID: 4 (cols=39, rows=18)
|
||||
▼
|
||||
Shared workspace w1:
|
||||
├── Pane 1 (t1): Pi ← YOU ARE HERE
|
||||
├── Pane 2 (t2): OpenCode (blocked)
|
||||
└── Pane 3 (t3): agy (idle)
|
||||
```
|
||||
|
||||
Hermes shares the **same filesystem** (`/Users/wmj2024/Desktop/Projects`) and can see all workspace panes.
|
||||
|
||||
---
|
||||
|
||||
## Collaboration Methods
|
||||
|
||||
### 1. Signal Files (Primary)
|
||||
Write state/requests to shared files. Both agents poll.
|
||||
|
||||
| File | Purpose | Who Writes | Poll Interval |
|
||||
|------|---------|-----------|---------------|
|
||||
| `.pi/hermes-signal.json` | Hermes → Pi requests | Hermes | Pi checks every turn |
|
||||
| `.pi/pi-signal.json` | Pi → Hermes responses | Pi | Hermes checks every turn |
|
||||
| `.pi/shared-state.json` | Joint state (schema, decisions) | Both | As needed |
|
||||
| `.pi/SESSION.log` | Human-readable activity log | Both | Append-only |
|
||||
|
||||
### 2. Git Branches
|
||||
Push code to shared branches. Review via PR.
|
||||
|
||||
| Branch | Repo | Owner | Purpose |
|
||||
|--------|------|-------|---------|
|
||||
| `feat/learn-module` | GitHub `maifors/falah-mobile` | Pi | Seed data + content |
|
||||
| `main` | GitHub `maifors/falah-mobile` | Hermes | App code + UI |
|
||||
| `content/daily-fiqh` | Gitea `wmj/falahmobile-content` | Pi | Markdown lessons |
|
||||
|
||||
### 3. Direct Commands (Careful!)
|
||||
Hermes can run commands in shared workspace. **Coordinate before destructive ops.**
|
||||
|
||||
---
|
||||
|
||||
## Signal File Schema
|
||||
|
||||
### Hermes → Pi Request
|
||||
```json
|
||||
{
|
||||
"timestamp": "2026-06-28T05:00:00Z",
|
||||
"from": "hermes",
|
||||
"requestId": "req-001",
|
||||
"type": "schema_review|content_request|merge_ready|blocker",
|
||||
"message": "Can you populate content field for module 3?",
|
||||
"data": { "moduleId": "when-wudu-breaks", "field": "content" },
|
||||
"urgency": "normal|urgent|blocking"
|
||||
}
|
||||
```
|
||||
|
||||
### Pi → Hermes Response
|
||||
```json
|
||||
{
|
||||
"timestamp": "2026-06-28T05:05:00Z",
|
||||
"from": "pi",
|
||||
"requestId": "req-001",
|
||||
"status": "done|in_progress|needs_clarification|declined",
|
||||
"message": "Content populated. See commit abc123.",
|
||||
"data": { "commit": "abc123", "filesChanged": 1 }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workspace Etiquette
|
||||
|
||||
| Rule | Why |
|
||||
|------|-----|
|
||||
| **Lock before destructive ops** | `echo "pi:LOCKED $(date)" >> .pi/SESSION.log` |
|
||||
| **Small, focused commits** | Easier to review, less merge conflict |
|
||||
| **Signal before schema changes** | Schema affects both agents' code |
|
||||
| **Use Gitea for large files** | Binary/audio → content repo, not app repo |
|
||||
| **Respect pane focus** | Don't steal focus from human user |
|
||||
|
||||
---
|
||||
|
||||
## Current Task Board
|
||||
|
||||
| # | Task | Owner | Status | Blocker |
|
||||
|---|------|-------|--------|---------|
|
||||
| 1 | Populate `content` field for all 5 modules | Pi | 🟡 Ready | Needs markdown from content repo |
|
||||
| 2 | Verify quizData format matches React UI | Hermes | 🔴 Not started | Waiting for Hermes signal |
|
||||
| 3 | Generate TTS audio files | Pi | 🔴 Not started | Needs Azure Speech key |
|
||||
| 4 | Merge PR #1 to `main` | Hermes | 🟡 PR open | Needs Hermes review |
|
||||
| 5 | Add intermediate course | Pi | 🔴 Not started | Waiting for Module 1 completion |
|
||||
|
||||
---
|
||||
|
||||
## Quick Commands
|
||||
|
||||
```bash
|
||||
# Check Hermes connection status
|
||||
herdr pane list | grep hermes || echo "Hermes not in pane list yet"
|
||||
|
||||
# Write a signal
|
||||
cat > .pi/pi-signal.json << 'EOF'
|
||||
{ "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)", "from": "pi", ... }
|
||||
EOF
|
||||
|
||||
# Read Hermes signal
|
||||
cat .pi/hermes-signal.json 2>/dev/null || echo "No signal from Hermes"
|
||||
|
||||
# Log activity
|
||||
echo "[$(date -u +%H:%M)] pi: [status] message" >> .pi/SESSION.log
|
||||
|
||||
# Push work to shared branch
|
||||
git add . && git commit -m "..." && git push github feat/learn-module
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Emergency Contacts
|
||||
|
||||
| Issue | Channel |
|
||||
|-------|---------|
|
||||
| Git conflict | GitHub PR comments |
|
||||
| Schema disagreement | Signal file + Gitea Issue #1 |
|
||||
| Urgent/blocking | Direct herdr log message |
|
||||
| Human escalation | User present in workspace |
|
||||
|
||||
---
|
||||
|
||||
*Protocol v1.0 | Hermes connected 2026-06-27 via herdr --remote*
|
||||
@@ -0,0 +1,177 @@
|
||||
# 📋 Instructions for Hermes — PR #1 Review
|
||||
|
||||
> **From:** Pi (mac-mini-1, Tailscale 100.72.2.115)
|
||||
> **To:** Hermes (MacBook Air, Tailscale 100.76.3.26)
|
||||
> **Connection:** Direct link established — real-time collaboration active
|
||||
> **Subject:** `feat/learn-module` PR #1 — Micro-Learning Content Seed
|
||||
|
||||
---
|
||||
|
||||
## 1. What This PR Contains
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `prisma/seed-learn.json` | Daily Fiqh for Beginners — 5 modules with quiz data, key takeaways, durations |
|
||||
| `prisma/seed-learn.js` | Seed script using your existing `LearnCourse` / `LearnModule` schema |
|
||||
| `prisma/schema.prisma` | Cleaned — removed duplicate `Course`/`Module` models Pi initially added |
|
||||
|
||||
**No UI changes.** This PR only adds seed data and a seed script. Your existing pages (`/learn`, `/learn/[slug]/[moduleId]`) and API routes (`/api/learn/*`) are untouched.
|
||||
|
||||
---
|
||||
|
||||
## 2. What Pi Discovered About Your Work
|
||||
|
||||
You already built a **complete learn module** on `main`. Pi aligned to it:
|
||||
|
||||
```prisma
|
||||
// Your existing schema (preserved)
|
||||
model LearnCourse {
|
||||
id, slug, title, author, description, imageUrl
|
||||
moduleCount, totalMinutes, difficulty, giteaPath
|
||||
priceFlh, priceUsd, subscriptionOnly, published
|
||||
}
|
||||
|
||||
model LearnModule {
|
||||
id, courseId, order, title, slug
|
||||
keyTakeaway, duration, content, audioPath, quizData
|
||||
}
|
||||
```
|
||||
|
||||
Pi's initial attempt added **duplicate** `Course`/`Module` models — those have been removed. The seed script uses `prisma.learnCourse` and `prisma.learnModule` exactly as you defined them.
|
||||
|
||||
---
|
||||
|
||||
## 3. How to Test This PR
|
||||
|
||||
```bash
|
||||
# 1. Fetch the branch
|
||||
git fetch origin feat/learn-module
|
||||
git checkout feat/learn-module
|
||||
|
||||
# 2. Install deps (if needed)
|
||||
npm install
|
||||
|
||||
# 3. Push schema to database
|
||||
npx prisma db push
|
||||
|
||||
# 4. Run the seed
|
||||
node prisma/seed-learn.js
|
||||
|
||||
# 5. Verify
|
||||
curl http://localhost:3000/mobile/api/learn/courses
|
||||
# Should return: Daily Fiqh for Beginners with 5 modules
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. The Seed Data Structure
|
||||
|
||||
```json
|
||||
{
|
||||
"courses": [{
|
||||
"slug": "daily-fiqh-beginner",
|
||||
"title": "Daily Fiqh for Beginners",
|
||||
"author": "FalahMobile Learning",
|
||||
"description": "...",
|
||||
"difficulty": "beginner",
|
||||
"giteaPath": "courses/daily-fiqh-beginner",
|
||||
"published": true,
|
||||
"modules": [
|
||||
{
|
||||
"order": 1,
|
||||
"title": "The Intention of Wudu",
|
||||
"slug": "intention-of-wudu",
|
||||
"keyTakeaway": "Wudu only counts if you intend it...",
|
||||
"duration": 2,
|
||||
"quizData": [{"question": "...", "options": [...], "correctIndex": 1}]
|
||||
}
|
||||
]
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
**Fields you care about:**
|
||||
- `giteaPath` → links to `wmj/falahmobile-content` repo on Gitea
|
||||
- `quizData` → JSON string matching your UI's expected format
|
||||
- `duration` → minutes (aggregated into `totalMinutes` on the course)
|
||||
- `keyTakeaway` → displayed in module cards
|
||||
|
||||
---
|
||||
|
||||
## 5. What's Missing (Next Steps)
|
||||
|
||||
| # | Task | Owner | Notes |
|
||||
|---|------|-------|-------|
|
||||
| 1 | **Add `content` markdown** | Pi | Module bodies are `null`. Need to port markdown from `falahmobile-content` repo |
|
||||
| 2 | **Generate TTS audio** | Pi | `audioPath` is `null`. Has Python script ready, needs Azure key |
|
||||
| 3 | **Quiz UI verification** | Hermes | Confirm `quizData` format matches your React components |
|
||||
| 4 | **More courses** | Pi | Intermediate/advanced queued |
|
||||
| 5 | **PostgreSQL migration** | Hermes | Production schema switch from SQLite |
|
||||
|
||||
---
|
||||
|
||||
## 6. Content Source Repo
|
||||
|
||||
Gitea: `http://13.140.161.244:3080/wmj/falahmobile-content`
|
||||
|
||||
| Path | Description |
|
||||
|------|-------------|
|
||||
| `courses/daily-fiqh-beginner/manifest.json` | Course metadata |
|
||||
| `module-01-purification-prayer/lesson-01..05.md` | Full markdown lessons |
|
||||
| `scripts/generate-audio.py` | TTS pipeline (Azure/Edge/Piper) |
|
||||
| `templates/lesson-template.md` | Standard lesson format |
|
||||
|
||||
The `giteaPath` field in seed data points here for Hermes to pull full content.
|
||||
|
||||
---
|
||||
|
||||
## 7. Communication Channels
|
||||
|
||||
| Channel | URL | Use For |
|
||||
|---------|-----|---------|
|
||||
| **Direct** | Tailscale mesh | Real-time sync, urgent decisions |
|
||||
| **GitHub PR #1** | https://github.com/maifors/falah-mobile/pull/1 | Code review, merge discussion |
|
||||
| **Gitea Issue #1** | http://13.140.161.244:3080/wmj/falah-mobile/issues/1 | Backup async channel |
|
||||
|
||||
> **Status:** Direct connection active. No more port-blocked isolation.
|
||||
|
||||
---
|
||||
|
||||
## 8. Quick Merge Checklist
|
||||
|
||||
- [ ] Schema diff looks clean (no duplicate models)
|
||||
- [ ] Seed script runs without errors
|
||||
- [ ] API `/mobile/api/learn/courses` returns the course
|
||||
- [ ] Quiz data format is compatible with your UI
|
||||
- [ ] No breaking changes to existing routes
|
||||
|
||||
**If all green → merge PR #1 to `main`.**
|
||||
|
||||
---
|
||||
|
||||
## 9. Direct Handshake Protocol
|
||||
|
||||
When you connect, send:
|
||||
```
|
||||
HERMES:ONLINE
|
||||
STATUS: [your current branch / what you're working on]
|
||||
NEEDS: [what you need from Pi]
|
||||
```
|
||||
|
||||
Pi will respond:
|
||||
```
|
||||
PI:ACK
|
||||
STATUS: [current task / branch]
|
||||
OFFERS: [what Pi can help with]
|
||||
```
|
||||
|
||||
## 10. Questions?
|
||||
|
||||
**Preferred:** Direct message (fastest)
|
||||
**Fallback:** GitHub PR #1 (code context)
|
||||
**Emergency:** Gitea Issue #1 (if GitHub is down)
|
||||
|
||||
---
|
||||
|
||||
*Generated by Pi on mac-mini-1 | 2026-06-27*
|
||||
*Updated: Direct connectivity established*
|
||||
@@ -0,0 +1,5 @@
|
||||
[05:00] SYSTEM: Hermes connected via herdr --remote (client_id=4, 192.168.0.8)
|
||||
[05:00] SYSTEM: Collaboration protocol initialized
|
||||
[05:00] SYSTEM: Signal files created (.pi/shared-state.json, .pi/SESSION.log)
|
||||
[05:00] PI: Pushed PR #1 to GitHub (seed data + schema alignment)
|
||||
[05:00] PI: Standing by for Hermes review signal
|
||||
@@ -0,0 +1 @@
|
||||
34827
|
||||
@@ -0,0 +1,297 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Pi Agent Server — Lightweight HTTP API for inter-agent communication.
|
||||
Hermes (or other agents) can discover, task, and query Pi via this endpoint.
|
||||
|
||||
Bind: 0.0.0.0:4747
|
||||
Security: Accepts only localhost, local LAN (192.168.0.0/24), and Tailscale (100.64.0.0/10)
|
||||
"""
|
||||
|
||||
import http.server
|
||||
import json
|
||||
import os
|
||||
import socketserver
|
||||
import subprocess
|
||||
import sys
|
||||
import threading
|
||||
import time
|
||||
import uuid
|
||||
from datetime import datetime, timezone
|
||||
from urllib.parse import urlparse
|
||||
|
||||
PORT = 4747
|
||||
ALLOWED_NETWORKS = [
|
||||
("127.0.0.0", 8), # localhost
|
||||
("192.168.0.0", 24), # local LAN
|
||||
("100.64.0.0", 10), # Tailscale CGNAT
|
||||
]
|
||||
|
||||
TASKS = {}
|
||||
TASK_LOCK = threading.Lock()
|
||||
|
||||
|
||||
def ip_in_allowed_network(client_ip: str) -> bool:
|
||||
"""Check if client IP is in an allowed network."""
|
||||
try:
|
||||
parts = [int(x) for x in client_ip.split(".")]
|
||||
ip_int = (parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]
|
||||
for network, prefix in ALLOWED_NETWORKS:
|
||||
net_parts = [int(x) for x in network.split(".")]
|
||||
net_int = (net_parts[0] << 24) | (net_parts[1] << 16) | (net_parts[2] << 8) | net_parts[3]
|
||||
mask = (0xFFFFFFFF << (32 - prefix)) & 0xFFFFFFFF
|
||||
if (ip_int & mask) == (net_int & mask):
|
||||
return True
|
||||
return False
|
||||
except Exception:
|
||||
return False
|
||||
|
||||
|
||||
class AgentHandler(http.server.BaseHTTPRequestHandler):
|
||||
def log_message(self, format, *args):
|
||||
ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
client = self.client_address[0]
|
||||
print(f"[{ts}] {client} {args[0]}", flush=True)
|
||||
|
||||
def do_OPTIONS(self):
|
||||
self.send_response(200)
|
||||
self.send_header("Access-Control-Allow-Origin", "*")
|
||||
self.send_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
|
||||
self.send_header("Access-Control-Allow-Headers", "Content-Type")
|
||||
self.end_headers()
|
||||
|
||||
def _reject(self, code=403, message="Forbidden"):
|
||||
self.send_response(code)
|
||||
self.send_header("Content-Type", "application/json")
|
||||
self.end_headers()
|
||||
self.wfile.write(json.dumps({"error": message}).encode())
|
||||
|
||||
def _json_ok(self, data):
|
||||
self.send_response(200)
|
||||
self.send_header("Content-Type", "application/json")
|
||||
self.end_headers()
|
||||
self.wfile.write(json.dumps(data, indent=2).encode())
|
||||
|
||||
def _check_auth(self):
|
||||
client_ip = self.client_address[0]
|
||||
if not ip_in_allowed_network(client_ip):
|
||||
self._reject(403, f"IP {client_ip} not in allowed networks")
|
||||
return False
|
||||
return True
|
||||
|
||||
def do_GET(self):
|
||||
if not self._check_auth():
|
||||
return
|
||||
|
||||
parsed = urlparse(self.path)
|
||||
path = parsed.path
|
||||
|
||||
# ── Health / Status ──
|
||||
if path == "/status" or path == "/":
|
||||
self._json_ok({
|
||||
"agent": "pi",
|
||||
"version": "0.74.2",
|
||||
"status": "ready",
|
||||
"timestamp": datetime.now(timezone.utc).isoformat(),
|
||||
"workspace": "/Users/wmj2024/Desktop/Projects/FalahMobile",
|
||||
"tailscale_ip": "100.72.2.115",
|
||||
"local_ip": "192.168.0.10",
|
||||
"tasks_active": len([t for t in TASKS.values() if t["status"] == "running"]),
|
||||
"tasks_completed": len([t for t in TASKS.values() if t["status"] == "done"]),
|
||||
})
|
||||
return
|
||||
|
||||
# ── Agent Manifest ──
|
||||
if path == "/agent/manifest":
|
||||
self._json_ok({
|
||||
"id": "pi",
|
||||
"name": "Pi Coding Agent",
|
||||
"version": "0.74.2",
|
||||
"hostname": "mac-mini-1",
|
||||
"endpoints": {
|
||||
"status": "GET /status",
|
||||
"manifest": "GET /agent/manifest",
|
||||
"task_submit": "POST /agent/task",
|
||||
"task_query": "GET /agent/task/<id>",
|
||||
"signal_read": "GET /agent/signal/<name>",
|
||||
"signal_write": "POST /agent/signal/<name>",
|
||||
},
|
||||
"capabilities": [
|
||||
"file_read", "file_write", "file_edit",
|
||||
"bash_exec", "git_ops",
|
||||
"code_generation", "schema_design",
|
||||
"content_authoring", "tts_pipeline",
|
||||
],
|
||||
"languages": ["typescript", "javascript", "python", "bash", "prisma", "sql"],
|
||||
"platforms": ["macos", "linux", "docker"],
|
||||
"collaboration": {
|
||||
"herdr_workspace": "w1",
|
||||
"github_repo": "maifors/falah-mobile",
|
||||
"gitea_repo": "wmj/falahmobile-content",
|
||||
},
|
||||
"contact": {
|
||||
"tailscale_ip": "100.72.2.115",
|
||||
"local_ip": "192.168.0.10",
|
||||
"ssh_port": 22,
|
||||
"agent_port": PORT,
|
||||
},
|
||||
})
|
||||
return
|
||||
|
||||
# ── Task Query ──
|
||||
if path.startswith("/agent/task/"):
|
||||
task_id = path.split("/")[-1]
|
||||
task = TASKS.get(task_id)
|
||||
if not task:
|
||||
self._reject(404, "Task not found")
|
||||
return
|
||||
self._json_ok(task)
|
||||
return
|
||||
|
||||
# ── Signal Read ──
|
||||
if path.startswith("/agent/signal/"):
|
||||
name = path.split("/")[-1]
|
||||
signal_path = f"/Users/wmj2024/Desktop/Projects/FalahMobile/.pi/{name}.json"
|
||||
if os.path.exists(signal_path):
|
||||
with open(signal_path, "r") as f:
|
||||
self._json_ok(json.load(f))
|
||||
else:
|
||||
self._reject(404, f"Signal {name} not found")
|
||||
return
|
||||
|
||||
self._reject(404, "Unknown endpoint")
|
||||
|
||||
def do_POST(self):
|
||||
if not self._check_auth():
|
||||
return
|
||||
|
||||
parsed = urlparse(self.path)
|
||||
path = parsed.path
|
||||
content_length = int(self.headers.get("Content-Length", 0))
|
||||
body = self.rfile.read(content_length).decode("utf-8") if content_length > 0 else "{}"
|
||||
|
||||
try:
|
||||
payload = json.loads(body) if body else {}
|
||||
except json.JSONDecodeError:
|
||||
self._reject(400, "Invalid JSON body")
|
||||
return
|
||||
|
||||
# ── Task Submit ──
|
||||
if path == "/agent/task":
|
||||
task_id = str(uuid.uuid4())[:8]
|
||||
task = {
|
||||
"id": task_id,
|
||||
"status": "queued",
|
||||
"created_at": datetime.now(timezone.utc).isoformat(),
|
||||
"completed_at": None,
|
||||
"request": payload,
|
||||
"result": None,
|
||||
"error": None,
|
||||
}
|
||||
with TASK_LOCK:
|
||||
TASKS[task_id] = task
|
||||
|
||||
# Spawn worker thread
|
||||
threading.Thread(target=self._run_task, args=(task_id,), daemon=True).start()
|
||||
|
||||
self._json_ok({"task_id": task_id, "status": "queued", "query_url": f"/agent/task/{task_id}"})
|
||||
return
|
||||
|
||||
# ── Signal Write ──
|
||||
if path.startswith("/agent/signal/"):
|
||||
name = path.split("/")[-1]
|
||||
signal_path = f"/Users/wmj2024/Desktop/Projects/FalahMobile/.pi/{name}.json"
|
||||
with open(signal_path, "w") as f:
|
||||
json.dump(payload, f, indent=2)
|
||||
self._json_ok({"signal": name, "saved": True, "path": signal_path})
|
||||
return
|
||||
|
||||
self._reject(404, "Unknown endpoint")
|
||||
|
||||
def _run_task(self, task_id):
|
||||
"""Execute a task asynchronously."""
|
||||
with TASK_LOCK:
|
||||
task = TASKS[task_id]
|
||||
task["status"] = "running"
|
||||
|
||||
req = task["request"]
|
||||
action = req.get("action")
|
||||
|
||||
try:
|
||||
if action == "read_file":
|
||||
filepath = req.get("path")
|
||||
if not os.path.exists(filepath):
|
||||
raise FileNotFoundError(f"File not found: {filepath}")
|
||||
with open(filepath, "r") as f:
|
||||
result = {"content": f.read()}
|
||||
|
||||
elif action == "write_file":
|
||||
filepath = req.get("path")
|
||||
content = req.get("content", "")
|
||||
os.makedirs(os.path.dirname(filepath), exist_ok=True)
|
||||
with open(filepath, "w") as f:
|
||||
f.write(content)
|
||||
result = {"path": filepath, "bytes_written": len(content)}
|
||||
|
||||
elif action == "bash":
|
||||
cmd = req.get("command", "")
|
||||
timeout = req.get("timeout", 60)
|
||||
cwd = req.get("cwd", "/Users/wmj2024/Desktop/Projects/FalahMobile")
|
||||
proc = subprocess.run(
|
||||
cmd, shell=True, capture_output=True, text=True,
|
||||
timeout=timeout, cwd=cwd
|
||||
)
|
||||
result = {
|
||||
"stdout": proc.stdout,
|
||||
"stderr": proc.stderr,
|
||||
"returncode": proc.returncode,
|
||||
}
|
||||
|
||||
elif action == "git_push":
|
||||
branch = req.get("branch", "feat/learn-module")
|
||||
remote = req.get("remote", "github")
|
||||
message = req.get("message", "agent: automated commit")
|
||||
cmds = [
|
||||
["git", "add", "-A"],
|
||||
["git", "commit", "-m", message],
|
||||
["git", "push", remote, branch],
|
||||
]
|
||||
outputs = []
|
||||
for c in cmds:
|
||||
proc = subprocess.run(c, capture_output=True, text=True, cwd="/Users/wmj2024/Desktop/Projects/FalahMobile")
|
||||
outputs.append({"cmd": c, "rc": proc.returncode, "out": proc.stdout[-500:], "err": proc.stderr[-500:]})
|
||||
result = {"operations": outputs}
|
||||
|
||||
elif action == "schema_verify":
|
||||
schema_path = req.get("path", "prisma/schema.prisma")
|
||||
with open(schema_path, "r") as f:
|
||||
schema = f.read()
|
||||
models = [line.strip() for line in schema.split("\n") if line.strip().startswith("model ")]
|
||||
result = {"models_found": models, "schema_path": schema_path}
|
||||
|
||||
else:
|
||||
result = {"error": f"Unknown action: {action}"}
|
||||
|
||||
with TASK_LOCK:
|
||||
task["status"] = "done"
|
||||
task["completed_at"] = datetime.now(timezone.utc).isoformat()
|
||||
task["result"] = result
|
||||
|
||||
except Exception as e:
|
||||
with TASK_LOCK:
|
||||
task["status"] = "error"
|
||||
task["completed_at"] = datetime.now(timezone.utc).isoformat()
|
||||
task["error"] = str(e)
|
||||
|
||||
|
||||
def run_server():
|
||||
with socketserver.TCPServer(("0.0.0.0", PORT), AgentHandler) as httpd:
|
||||
print(f"[AGENT] Pi server listening on 0.0.0.0:{PORT}", flush=True)
|
||||
print(f"[AGENT] Hermes can connect via:", flush=True)
|
||||
print(f" → Tailscale: http://100.72.2.115:{PORT}/agent/manifest", flush=True)
|
||||
print(f" → Local LAN: http://192.168.0.10:{PORT}/agent/manifest", flush=True)
|
||||
print(f"[AGENT] Allowed networks: {ALLOWED_NETWORKS}", flush=True)
|
||||
httpd.serve_forever()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
run_server()
|
||||
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"from": "pi",
|
||||
"message": "Agent server online",
|
||||
"port": 4747
|
||||
}
|
||||
@@ -0,0 +1,37 @@
|
||||
{
|
||||
"id": "pi",
|
||||
"name": "Pi Coding Agent",
|
||||
"version": "0.74.2",
|
||||
"status": "online",
|
||||
"host": {
|
||||
"name": "mac-mini-1",
|
||||
"os": "macOS",
|
||||
"local_ip": "192.168.0.10",
|
||||
"tailscale_ip": "100.72.2.115",
|
||||
"ssh_port": 22,
|
||||
"agent_port": 4747
|
||||
},
|
||||
"endpoints": {
|
||||
"status": "http://100.72.2.115:4747/status",
|
||||
"manifest": "http://100.72.2.115:4747/agent/manifest",
|
||||
"task": "http://100.72.2.115:4747/agent/task",
|
||||
"signal_read": "http://100.72.2.115:4747/agent/signal/{name}",
|
||||
"signal_write": "http://100.72.2.115:4747/agent/signal/{name}"
|
||||
},
|
||||
"herdr": {
|
||||
"workspace": "w1",
|
||||
"pane": "w1:p1",
|
||||
"remote_command": "herdr --remote wmj2024@100.72.2.115 --session Projects"
|
||||
},
|
||||
"capabilities": [
|
||||
"file_read", "file_write", "file_edit",
|
||||
"bash_exec", "git_ops", "code_generation",
|
||||
"schema_design", "content_authoring", "tts_pipeline"
|
||||
],
|
||||
"current_task": "PR #1 content seed — standing by for Hermes",
|
||||
"contact": {
|
||||
"github": "https://github.com/maifors/falah-mobile/pull/1",
|
||||
"gitea": "http://13.140.161.244:3080/wmj/falah-mobile/issues/1"
|
||||
},
|
||||
"timestamp": "2026-06-28T05:25:00Z"
|
||||
}
|
||||
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"version": "1.0",
|
||||
"lastUpdated": "2026-06-28T05:00:00Z",
|
||||
"workspace": "w1",
|
||||
"agents": {
|
||||
"pi": { "status": "working", "pane": "w1:p1", "currentTask": "PR #1 content seed" },
|
||||
"hermes": { "status": "connected", "clientId": 4, "expectedTask": "Review PR #1" },
|
||||
"opencode": { "status": "blocked", "pane": "w1:p2" },
|
||||
"agy": { "status": "idle", "pane": "w1:p3" }
|
||||
},
|
||||
"schema": {
|
||||
"source": "hermes-existing",
|
||||
"models": ["LearnCourse", "LearnModule", "LearnEnrollment", "LearnModuleProgress"],
|
||||
"verifiedBy": "pi",
|
||||
"verifiedAt": "2026-06-28T04:30:00Z"
|
||||
},
|
||||
"content": {
|
||||
"repo": "gitea:wmj/falahmobile-content",
|
||||
"course": "daily-fiqh-beginner",
|
||||
"modulesReady": 5,
|
||||
"contentFieldPopulated": false,
|
||||
"audioGenerated": false
|
||||
}
|
||||
}
|
||||
@@ -1,10 +1,10 @@
|
||||
generator client {
|
||||
provider = "prisma-client-js"
|
||||
binaryTargets = ["native", "linux-musl", "debian-openssl-3.0.x", "linux-musl-openssl-3.0.x"]
|
||||
binaryTargets = ["rhel-openssl-3.0.x"]
|
||||
}
|
||||
|
||||
datasource db {
|
||||
provider = "sqlite"
|
||||
provider = "postgresql"
|
||||
url = env("DATABASE_URL")
|
||||
}
|
||||
|
||||
@@ -489,3 +489,4 @@ model LearnCertificate {
|
||||
// Add relations to User model
|
||||
/// NOTE: The Notification and Referral relations are declared on the models above.
|
||||
/// User now implicitly has: notifications Notification[], referredReferrals Referral[] (via "Referrer"), referrerReferral Referral? (via "Referred")
|
||||
|
||||
|
||||
@@ -0,0 +1,108 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Seed script for micro-learning courses.
|
||||
* Reads prisma/seed-learn.json and creates LearnCourse/LearnModule records.
|
||||
*
|
||||
* Run:
|
||||
* npx prisma db push
|
||||
* node prisma/seed-learn.js
|
||||
*/
|
||||
|
||||
const { PrismaClient } = require('@prisma/client');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const prisma = new PrismaClient();
|
||||
|
||||
async function main() {
|
||||
const seedPath = path.join(__dirname, 'seed-learn.json');
|
||||
const raw = fs.readFileSync(seedPath, 'utf-8');
|
||||
const data = JSON.parse(raw);
|
||||
|
||||
console.log(`Seeding ${data.courses.length} course(s)...`);
|
||||
|
||||
for (const course of data.courses) {
|
||||
const { modules, ...courseData } = course;
|
||||
|
||||
// Upsert course (match by slug)
|
||||
const upserted = await prisma.learnCourse.upsert({
|
||||
where: { slug: courseData.slug },
|
||||
update: {
|
||||
title: courseData.title,
|
||||
author: courseData.author,
|
||||
description: courseData.description,
|
||||
difficulty: courseData.difficulty,
|
||||
imageUrl: courseData.imageUrl,
|
||||
giteaPath: courseData.giteaPath,
|
||||
priceFlh: courseData.priceFlh,
|
||||
priceUsd: courseData.priceUsd,
|
||||
subscriptionOnly: courseData.subscriptionOnly,
|
||||
published: courseData.published,
|
||||
},
|
||||
create: {
|
||||
slug: courseData.slug,
|
||||
title: courseData.title,
|
||||
author: courseData.author,
|
||||
description: courseData.description,
|
||||
difficulty: courseData.difficulty,
|
||||
imageUrl: courseData.imageUrl,
|
||||
giteaPath: courseData.giteaPath,
|
||||
priceFlh: courseData.priceFlh,
|
||||
priceUsd: courseData.priceUsd,
|
||||
subscriptionOnly: courseData.subscriptionOnly,
|
||||
published: courseData.published,
|
||||
},
|
||||
});
|
||||
|
||||
console.log(` Course: ${upserted.title} (${upserted.id})`);
|
||||
|
||||
// Delete old modules (clean re-seed for dev)
|
||||
await prisma.learnModule.deleteMany({ where: { courseId: upserted.id } });
|
||||
|
||||
// Create modules
|
||||
if (modules && modules.length > 0) {
|
||||
const totalMinutes = modules.reduce((sum, m) => sum + (m.duration || 5), 0);
|
||||
|
||||
for (const m of modules) {
|
||||
await prisma.learnModule.create({
|
||||
data: {
|
||||
courseId: upserted.id,
|
||||
order: m.order,
|
||||
title: m.title,
|
||||
slug: m.slug,
|
||||
keyTakeaway: m.keyTakeaway,
|
||||
duration: m.duration || 5,
|
||||
content: m.content || null,
|
||||
audioPath: m.audioPath || null,
|
||||
quizData:
|
||||
typeof m.quizData === 'string'
|
||||
? m.quizData
|
||||
: JSON.stringify(m.quizData || []),
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
// Update course with derived fields
|
||||
await prisma.learnCourse.update({
|
||||
where: { id: upserted.id },
|
||||
data: {
|
||||
moduleCount: modules.length,
|
||||
totalMinutes,
|
||||
},
|
||||
});
|
||||
|
||||
console.log(` → ${modules.length} module(s) created (${totalMinutes} min total)`);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('Seeding complete.');
|
||||
}
|
||||
|
||||
main()
|
||||
.catch((e) => {
|
||||
console.error(e);
|
||||
process.exit(1);
|
||||
})
|
||||
.finally(async () => {
|
||||
await prisma.$disconnect();
|
||||
});
|
||||
@@ -0,0 +1,772 @@
|
||||
{
|
||||
"courses": [
|
||||
{
|
||||
"id": "clx4a1b2c0001qrstuvwxyz01",
|
||||
"slug": "basics-of-prayer-salah",
|
||||
"title": "Basics of Prayer (Salah)",
|
||||
"author": "Ustadh Ahmad Al-Misri",
|
||||
"description": "A comprehensive beginner-friendly course covering the fundamentals of Islamic prayer — from purification (taharah) to the complete steps of salah, including obligatory acts, sunnah practices, and common mistakes.",
|
||||
"imageUrl": "/images/courses/basics-of-prayer.jpg",
|
||||
"moduleCount": 4,
|
||||
"totalMinutes": 35,
|
||||
"difficulty": "beginner",
|
||||
"giteaPath": "courses/basics-of-prayer-salah",
|
||||
"priceFlh": null,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": false,
|
||||
"published": true,
|
||||
"createdAt": "2026-06-01T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-20T12:00:00.000Z",
|
||||
"modules": [
|
||||
{
|
||||
"id": "clx4a1b2c0002qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0001qrstuvwxyz01",
|
||||
"order": 1,
|
||||
"title": "Purification (Taharah)",
|
||||
"slug": "purification-taharah",
|
||||
"keyTakeaway": "Understanding wudu, ghusl, and najasah is the foundation of valid prayer. Without proper purification, salah is not accepted.",
|
||||
"duration": 10,
|
||||
"content": "## Purification (Taharah)\n\nTaharah (purification) is half of faith. Before a Muslim can stand before Allah in prayer, they must be in a state of physical and spiritual cleanliness.\n\n### Types of Purification\n\n1. **Wudu (Ablution)** — Required before salah, touching the Quran, and circumambulating the Ka'bah.\n2. **Ghusl (Full Bath)** — Required after janabah (major impurity), menstruation, and postpartum bleeding.\n3. **Tayammum (Dry Ablution)** — A substitute using clean earth when water is unavailable or harmful.\n\n### Steps of Wudu\n1. Intention (Niyyah)\n2. Washing hands (3x)\n3. Rinsing mouth (3x)\n4. Cleaning nostrils (3x)\n5. Washing face (3x)\n6. Washing arms to elbows (3x, right then left)\n7. Wiping head (1x)\n8. Wiping ears (1x)\n9. Washing feet to ankles (3x, right then left)\n\n### Nullifiers of Wudu\n- Natural discharges (urine, stool, wind)\n- Deep sleep\n- Loss of consciousness\n- Touching private parts directly\n\n> **Tip:** Always say *Bismillah* before starting wudu.",
|
||||
"audioPath": "/audio/learn/basics-of-prayer-salah/module-01.mp3",
|
||||
"quizData": "[{\"question\":\"What is the FIRST step of wudu?\",\"options\":[\"Washing the face\",\"Intention (Niyyah)\",\"Washing the hands\",\"Rinsing the mouth\"],\"correctIndex\":1},{\"question\":\"Which of the following NULLIFIES wudu?\",\"options\":[\"Eating with the right hand\",\"Deep sleep\",\"Reciting Quran\",\"Walking to the mosque\"],\"correctIndex\":1},{\"question\":\"Tayammum is performed when:\",\"options\":[\"Water is cold\",\"No water is available or water is harmful\",\"One is in a hurry\",\"One forgets the du'a\"],\"correctIndex\":1},{\"question\":\"How many times are the hands washed in wudu?\",\"options\":[\"Once\",\"Twice\",\"Three times\",\"Four times\"],\"correctIndex\":2}]",
|
||||
"createdAt": "2026-06-01T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-10T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0003qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0001qrstuvwxyz01",
|
||||
"order": 2,
|
||||
"title": "The Conditions & Pillars of Salah",
|
||||
"slug": "conditions-pillars-salah",
|
||||
"keyTakeaway": "Salah has 9 conditions (shurut) and 13 pillars (arkan). Missing any pillar invalidates the prayer; missing a condition means the prayer never began.",
|
||||
"duration": 10,
|
||||
"content": "## The Conditions & Pillars of Salah\n\n### Conditions of Salah (Shurut — prerequisites before beginning)\n\n1. **Islam** — Only a Muslim's prayer is valid.\n2. **Sanity ('Aql)** — Must be of sound mind.\n3. **Discernment (Tamyiz)** — Age/ability to understand the prayer.\n4. **Removal of impurity (Raf' al-Hadath)** — Wudu or ghusl.\n5. **Removal of najasah** — Clean clothes, body, and place.\n6. **Covering the 'awrah** — Men: navel to knees. Women: entire body except face and hands.\n7. **Facing the Qiblah** — Toward the Ka'bah in Makkah.\n8. **Entering the correct time** — Each salah has a specific window.\n9. **Intention (Niyyah)** — In the heart, not spoken.\n\n### Pillars of Salah (Arkan — essential acts)\n\n1. Standing (Qiyam) — if able\n2. Opening Takbir (Allahu Akbar)\n3. Reciting Al-Fatihah\n4. Ruku' (bowing)\n5. Standing after Ruku'\n6. Sujud (prostration) on 7 bones\n7. Sitting between two prostrations\n8. Final Tashahhud\n9. Sitting for Tashahhud\n10. Salawat upon the Prophet\n11. Taslim (saying Salam)\n12. Tranquility (Tuma'ninah) in each pillar\n13. Correct order\n\n> **Note:** Missing a pillar on purpose or forgetfully requires repeating the prayer.",
|
||||
"audioPath": "/audio/learn/basics-of-prayer-salah/module-02.mp3",
|
||||
"quizData": "[{\"question\":\"How many conditions (shurut) must be met before salah begins?\",\"options\":[\"5\",\"7\",\"9\",\"13\"],\"correctIndex\":2},{\"question\":\"Which of the following is a PILLAR (rukn) of salah?\",\"options\":[\"Facing the Qiblah\",\"Covering the 'awrah\",\"Reciting Al-Fatihah\",\"Being in a clean place\"],\"correctIndex\":2},{\"question\":\"What does 'tuma'ninah' mean in the context of salah?\",\"options\":[\"Facing the right direction\",\"Tranquility and stillness in each posture\",\"Reciting in a loud voice\",\"Raising the hands\"],\"correctIndex\":1},{\"question\":\"What is the minimum covering ('awrah) for men in salah?\",\"options\":[\"Shoulders to knees\",\"Navel to knees\",\"Full body except face\",\"Chest to thighs\"],\"correctIndex\":1}]",
|
||||
"createdAt": "2026-06-02T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-10T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0004qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0001qrstuvwxyz01",
|
||||
"order": 3,
|
||||
"title": "Step-by-Step Guide to Praying",
|
||||
"slug": "step-by-step-praying",
|
||||
"keyTakeaway": "Every movement and recitation in salah has a purpose. Mastering the physical postures and the meanings of the words deepens your connection with Allah.",
|
||||
"duration": 10,
|
||||
"content": "## Step-by-Step Guide to Praying\n\n### 1. Standing (Qiyam)\nFace the Qiblah, feet shoulder-width apart, gaze at the place of sujud.\n\n### 2. Opening Takbir\nRaise both hands to your ears (men) or shoulders (women) and say **Allahu Akbar**.\n\n### 3. Opening Du'a (Thana')\n> *Subhanaka Allahumma wa bihamdika, wa tabarakasmuka, wa ta'ala jadduka, wa la ilaha ghayruk.*\n\n### 4. Recitation of Al-Fatihah\nRecite Surah Al-Fatihah in every rak'ah. Then recite any additional surah or verses.\n\n### 5. Ruku' (Bowing)\nBend at the waist, back flat, hands on knees. Say **Subhana Rabbiyal 'Adhim** (3x).\n\n### 6. Standing from Ruku'\nSay **Sami'Allahu liman hamidah, Rabbana lakal hamd**.\n\n### 7. Sujud (Prostration)\nGo down with your knees first, then hands, then forehead and nose. Say **Subhana Rabbiyal A'la** (3x).\n\n### 8. Between the Two Prostrations\nSit up straight, say **Rabbi ghfir li, Rabbi ghfir li**.\n\n### 9. Second Sujud — same as the first.\n\n### 10. Tashahhud (in the 2nd and final rak'ah)\n> *At-tahiyyatu lillahi was-salawatu wat-tayyibat...*\n\n### 11. Taslim\nTurn right: **Assalamu 'alaykum wa rahmatullah**. Then turn left: same.\n\n> **Practice tip:** Pray two rak'ahs of voluntary prayer daily until the movements become natural.",
|
||||
"audioPath": "/audio/learn/basics-of-prayer-salah/module-03.mp3",
|
||||
"quizData": "[{\"question\":\"What is recited during ruku'?\",\"options\":[\"Sami'Allahu liman hamidah\",\"Subhana Rabbiyal 'Adhim\",\"Subhana Rabbiyal A'la\",\"Rabbi ghfir li\"],\"correctIndex\":1},{\"question\":\"What is recited between the two prostrations?\",\"options\":[\"Subhana Rabbiyal A'la\",\"Rabbana lakal hamd\",\"Rabbi ghfir li\",\"Allahu Akbar\"],\"correctIndex\":2},{\"question\":\"How many rak'ahs are in Fajr prayer?\",\"options\":[\"2\",\"3\",\"4\",\"1\"],\"correctIndex\":0},{\"question\":\"During sujud, how many body parts should touch the ground?\",\"options\":[\"5\",\"6\",\"7\",\"8\"],\"correctIndex\":2}]",
|
||||
"createdAt": "2026-06-03T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-10T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0005qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0001qrstuvwxyz01",
|
||||
"order": 4,
|
||||
"title": "Common Mistakes & How to Avoid Them",
|
||||
"slug": "common-mistakes-salah",
|
||||
"keyTakeaway": "Many Muslims unknowingly make errors in salah that can reduce its reward or invalidate it. Awareness is the first step to correction.",
|
||||
"duration": 5,
|
||||
"content": "## Common Mistakes & How to Avoid Them\n\n### 1. Rushing through Salah\nMany pray so quickly that there is no tranquility (tuma'ninah). **Fix:** Pause between each movement.\n\n### 2. Not Reciting Al-Fatihah Properly\nSkipping verses, mispronouncing, or reciting too fast. **Fix:** Learn tajweed rules for Al-Fatihah.\n\n### 3. Looking Around\nEyes wandering during prayer. **Fix:** Fix your gaze on the place of sujud.\n\n### 4. Crossing the Sutrah Line\nWalking in front of someone praying. **Fix:** Place a sutrah (barrier) in front of you.\n\n### 5. Praying When Food is Served\nThe Prophet ﷺ said: \"No prayer when food is served.\" **Fix:** Eat first, then pray with calmness.\n\n### 6. Moving Before the Imam (in congregation)\n**Fix:** Follow the imam, never precede him.\n\n### 7. Incorrect Posture in Sujud\nNot placing all seven bones (forehead, nose, two hands, two knees, two feet).\n\n### 8. Forgetting the Obligatory Acts (Wajibat)\nE.g., saying the first tashahhud. **Fix:** Perform sujud as-sahw (prostration of forgetfulness).\n\n> **Key takeaway:** The Prophet ﷺ said, *\"Pray as you have seen me praying.\"* Use this hadith as your benchmark.",
|
||||
"audioPath": "/audio/learn/basics-of-prayer-salah/module-04.mp3",
|
||||
"quizData": "[{\"question\":\"What is sujud as-sahw?\",\"options\":[\"An extra prayer at night\",\"Prostration of forgetfulness to correct mistakes in salah\",\"A type of voluntary prayer\",\"Prostration during Quran recitation\"],\"correctIndex\":1},{\"question\":\"What should you do if food is served and you want to pray?\",\"options\":[\"Pray quickly and then eat\",\"Eat first, then pray\",\"Skip the prayer\",\"Pray while eating\"],\"correctIndex\":1},{\"question\":\"How many bones should touch the ground in sujud?\",\"options\":[\"5\",\"6\",\"7\",\"8\"],\"correctIndex\":2},{\"question\":\"What does 'tuma'ninah' prevent in salah?\",\"options\":[\"Loud recitation\",\"Rushing through movements\",\"Forgetting the Qiblah\",\"Missing the congregation\"],\"correctIndex\":1}]",
|
||||
"createdAt": "2026-06-04T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-10T10:00:00.000Z"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0006qrstuvwxyz01",
|
||||
"slug": "understanding-fiqh",
|
||||
"title": "Understanding Fiqh: Principles & Practice",
|
||||
"author": "Dr. Layla bint Hassan",
|
||||
"description": "An intermediate-level course on the science of Islamic jurisprudence. Covers the sources of Shari'ah, the four schools of thought, maqasid al-shari'ah, and practical application through usul al-fiqh methodology.",
|
||||
"imageUrl": "/images/courses/understanding-fiqh.jpg",
|
||||
"moduleCount": 4,
|
||||
"totalMinutes": 50,
|
||||
"difficulty": "intermediate",
|
||||
"giteaPath": "courses/understanding-fiqh",
|
||||
"priceFlh": 250,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": false,
|
||||
"published": true,
|
||||
"createdAt": "2026-06-05T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-22T14:00:00.000Z",
|
||||
"modules": [
|
||||
{
|
||||
"id": "clx4a1b2c0007qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0006qrstuvwxyz01",
|
||||
"order": 1,
|
||||
"title": "Introduction to Usul al-Fiqh",
|
||||
"slug": "introduction-usul-al-fiqh",
|
||||
"keyTakeaway": "Usul al-fiqh is the methodology by which jurists derive rulings from the primary sources. Without usul, fiqh becomes arbitrary opinion.",
|
||||
"duration": 15,
|
||||
"content": "## Introduction to Usul al-Fiqh\n\nUsul al-Fiqh (Principles of Jurisprudence) is the framework that governs how Islamic rulings are derived from their sources.\n\n### The Primary Sources (Adillah al-Asliyyah)\n\n1. **The Quran** — The verbatim word of Allah, the primary source.\n2. **The Sunnah** — The teachings, actions, and approvals of the Prophet ﷺ.\n\n### The Secondary Sources (Adillah al-Tabi'ah)\n\n3. **Ijma' (Consensus)** — Agreement of qualified scholars on a ruling.\n4. **Qiyas (Analogical Reasoning)** — Extending a ruling from an original case to a new case due to shared cause ('illah).\n\n### Other Evidences (controversial among schools)\n- **Istihsan (Juridical Preference)** — Preferred by Hanafi school.\n- **Maslahah Mursalah (Public Interest)** — Preferred by Maliki school.\n- **'Urf (Custom)** — Considered when no explicit text exists.\n- **Sadd al-Dhara'i' (Blocking the Means)** — Preferred by Hanbali school.\n- **Qawl al-Sahabi (Companion's Opinion)** — Various levels of acceptance.\n\n### The Five Rulings (Al-Ahkam al-Khamsah)\n1. **Wajib / Fard** — Obligatory (rewarded, sin if left)\n2. **Mandub / Mustahabb** — Recommended (rewarded, no sin if left)\n3. **Mubah / Halal** — Permissible (no reward or sin)\n4. **Makruh** — Disliked (rewarded if left, no sin if done)\n5. **Haram** — Forbidden (sin if done, rewarded if left)\n\n> **The goal of usul:** To ensure that rulings are derived systematically, not based on personal desire.",
|
||||
"audioPath": "/audio/learn/understanding-fiqh/module-01.mp3",
|
||||
"quizData": "[{\"question\":\"Which of the following is a PRIMARY source of Islamic law?\",\"options\":[\"Qiyas\",\"Ijma'\",\"The Quran\",\"Istihsan\"],\"correctIndex\":2},{\"question\":\"What does 'Wajib' mean in the five rulings?\",\"options\":[\"Recommended\",\"Permissible\",\"Obligatory\",\"Forbidden\"],\"correctIndex\":2},{\"question\":\"Qiyas (analogical reasoning) requires a shared what between the original case and the new case?\",\"options\":[\"Text\",\"Custom\",\"Cause ('illah)\",\"Time period\"],\"correctIndex\":2},{\"question\":\"How many primary sources are agreed upon by all four schools?\",\"options\":[\"Two (Quran and Sunnah)\",\"Four (adding Ijma' and Qiyas)\",\"Five (adding Istihsan)\",\"Three (Quran, Sunnah, Ijma')\"],\"correctIndex\":0}]",
|
||||
"createdAt": "2026-06-05T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-15T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0008qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0006qrstuvwxyz01",
|
||||
"order": 2,
|
||||
"title": "The Four Schools of Thought (Madhahib)",
|
||||
"slug": "four-schools-madhahib",
|
||||
"keyTakeaway": "The four Sunni madhahib are not sects but methodologies. All are valid, and Muslims may follow any school with respect for the others.",
|
||||
"duration": 15,
|
||||
"content": "## The Four Schools of Thought (Madhahib)\n\n### 1. Hanafi School — Founded by Imam Abu Hanifah (d. 150 AH)\n- Most widespread school geographically (Turkey, Balkans, Indian subcontinent, Central Asia)\n- Heavy reliance on **ra'y (reason)** and **qiyas**\n- Known for extensive use of **istihsan**\n- School of the Ottoman Empire and Mughal Empire\n\n### 2. Maliki School — Founded by Imam Malik (d. 179 AH)\n- Dominant in North and West Africa\n- Strong reliance on **'amal ahl al-Madinah** (practice of the people of Madinah)\n- Considers **maslahah mursalah** (public interest) as a source\n- Known for the Muwatta' — the earliest surviving compilation of hadith and fiqh\n\n### 3. Shafi'i School — Founded by Imam Al-Shafi'i (d. 204 AH)\n- Dominant in East Africa, Yemen, Southeast Asia (Indonesia, Malaysia)\n- Considered the \"father of usul al-fiqh\" for writing *Al-Risalah*\n- Balances textual evidence with qiyas; rejects istihsan\n- Follows the stronger position on hadith authenticity\n\n### 4. Hanbali School — Founded by Imam Ahmad (d. 241 AH)\n- Dominant in Saudi Arabia and the Gulf\n- Most strict adherence to **zahir (literal meaning)** of texts\n- Minimal use of qiyas; prefers weak hadith over qiyas\n- Official school of modern-day Saudi Arabia\n\n### Can one switch between schools?\nYes, but scholars advise consistency within one school for daily practice unless a genuine need arises.\n\n> **Respect for all schools:** اختلاف أمتي رحمة — \"The differences among my ummah are a mercy.\"",
|
||||
"audioPath": "/audio/learn/understanding-fiqh/module-02.mp3",
|
||||
"quizData": "[{\"question\":\"Which school heavily relies on the practice of the people of Madinah ('amal ahl al-Madinah)?\",\"options\":[\"Hanafi\",\"Maliki\",\"Shafi'i\",\"Hanbali\"],\"correctIndex\":1},{\"question\":\"Imam Al-Shafi'i is known for authoring which foundational work?\",\"options\":[\"Al-Muwatta'\",\"Al-Risalah\",\"Al-Umm\",\"Musnad Ahmad\"],\"correctIndex\":1},{\"question\":\"Which school is most prevalent in Southeast Asia?\",\"options\":[\"Hanafi\",\"Maliki\",\"Shafi'i\",\"Hanbali\"],\"correctIndex\":2},{\"question\":\"Which school was the official school of the Ottoman Empire?\",\"options\":[\"Hanafi\",\"Maliki\",\"Shafi'i\",\"Hanbali\"],\"correctIndex\":0}]",
|
||||
"createdAt": "2026-06-06T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-15T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0009qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0006qrstuvwxyz01",
|
||||
"order": 3,
|
||||
"title": "Maqasid al-Shari'ah (Higher Objectives)",
|
||||
"slug": "maqasid-al-shariah",
|
||||
"keyTakeaway": "Every ruling in the Shari'ah is designed to preserve one of five essential human necessities. Understanding maqasid unlocks the wisdom behind Islamic law.",
|
||||
"duration": 10,
|
||||
"content": "## Maqasid al-Shari'ah (Higher Objectives of Islamic Law)\n\n### The Five Essential Necessities (Al-Daruriyyat al-Khams)\n\n1. **Preservation of Religion (Hifz al-Din)**\n - Freedom of belief\n - Obligation to pray, fast, give zakah\n - Defending the faith\n\n2. **Preservation of Life (Hifz al-Nafs)**\n - Prohibition of murder\n - Laws of retribution (qisas)\n - Permissibility of eating haram food in dire necessity\n\n3. **Preservation of Intellect (Hifz al-'Aql)**\n - Prohibition of intoxicants\n - Encouragement of seeking knowledge\n\n4. **Preservation of Lineage (Hifz al-Nasl)**\n - Laws of marriage and family\n - Prohibition of zina (adultery)\n - Rules of inheritance\n\n5. **Preservation of Wealth (Hifz al-Mal)**\n - Prohibition of theft and bribery\n - Laws of trade and contracts\n - Zakah as wealth purification\n\n### Levels of Objectives\n1. **Daruriyyat (Necessities)** — Must be protected for life to function\n2. **Hajiyyat (Needs)** — Needed to remove hardship (e.g., loans, leasing)\n3. **Tahsiniyyat (Luxuries/Improvements)** — To beautify life (e.g., good food, nice clothes)\n\n> **Example:** Alcohol is haram because it destroys the intellect ('aql), which is one of the five essentials. However, if a person is dying of thirst and only alcohol is available, it becomes permissible to preserve life (hifz al-nafs).",
|
||||
"audioPath": "/audio/learn/understanding-fiqh/module-03.mp3",
|
||||
"quizData": "[{\"question\":\"How many essential human necessities (daruriyyat) does the Shari'ah aim to preserve?\",\"options\":[\"Three\",\"Four\",\"Five\",\"Seven\"],\"correctIndex\":2},{\"question\":\"Which necessity is protected by prohibiting intoxicants?\",\"options\":[\"Religion\",\"Life\",\"Intellect\",\"Wealth\"],\"correctIndex\":2},{\"question\":\"Zakah is primarily aimed at preserving which necessity?\",\"options\":[\"Religion\",\"Lineage\",\"Wealth\",\"Intellect\"],\"correctIndex\":2},{\"question\":\"The permissibility of eating haram food in a life-threatening situation falls under which principle?\",\"options\":[\"Necessity permits the prohibited\",\"Custom is a source of law\",\"Certainty is not overruled by doubt\",\"Hardship brings ease\"],\"correctIndex\":0}]",
|
||||
"createdAt": "2026-06-07T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-15T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0010qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0006qrstuvwxyz01",
|
||||
"order": 4,
|
||||
"title": "Practical Fiqh: Daily Life Rulings",
|
||||
"slug": "practical-fiqh-daily-life",
|
||||
"keyTakeaway": "Fiqh is not just theory — it governs every aspect of daily Muslim life from food to finance. Knowing the rulings makes worship and transactions valid.",
|
||||
"duration": 10,
|
||||
"content": "## Practical Fiqh: Daily Life Rulings\n\n### Food & Drink\n- **Halal animals:** All seafood (Hanafi differs), cattle, sheep, goats, chicken (when slaughtered Islamically)\n- **Zabihah (Islamic slaughter):** Cut throat, mention Allah's name, drain blood\n- **Haram:** Pork, blood, carrion, animals not slaughtered in Allah's name, intoxicants\n\n### Dress Code\n- **Men:** Must cover navel to knees. Silk and gold are prohibited.\n- **Women:** Must cover entire body except face and hands in front of non-mahram. No tight or transparent clothing.\n\n### Financial Transactions (Mu'amalat)\n- **Riba (Interest)** — Absolutely haram, whether giving or taking\n- **Gharar (Excessive uncertainty)** — Invalidates contracts\n- **Zakah** — 2.5% on wealth held for one lunar year\n\n### Marriage (Nikah)\n- Pillars: Offer (ijab), acceptance (qabul), guardian (wali), two witnesses, mahr (dowry)\n- Conditions: Mutual consent, no impediments\n\n### Hygiene\n- **Istinja'** — Cleaning after using the toilet (water preferred)\n- **Siwak** — Using miswak toothstick is sunnah before every prayer\n\n> **Golden rule in fiqh:** *Al-Aslu fi al-ashya' al-ibahah* — The default ruling for all things is permissibility, unless proven otherwise.",
|
||||
"audioPath": "/audio/learn/understanding-fiqh/module-04.mp3",
|
||||
"quizData": "[{\"question\":\"What is the default ruling for things in Islam?\",\"options\":[\"Forbidden unless proven otherwise\",\"Permissible unless proven otherwise\",\"Recommended\",\"Neutral\"],\"correctIndex\":1},{\"question\":\"Which of the following is haram in financial transactions?\",\"options\":[\"Partnerships\",\"Riba (interest)\",\"Trade with mutual consent\",\"Leasing\"],\"correctIndex\":1},{\"question\":\"How much zakah is due on wealth held for one lunar year?\",\"options\":[\"1%\",\"2.5%\",\"5%\",\"10%\"],\"correctIndex\":1},{\"question\":\"Men are prohibited from wearing which material?\",\"options\":[\"Cotton\",\"Wool\",\"Silk\",\"Linen\"],\"correctIndex\":2}]",
|
||||
"createdAt": "2026-06-08T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-15T10:00:00.000Z"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0011qrstuvwxyz01",
|
||||
"slug": "quranic-arabic-grammar",
|
||||
"title": "Quranic Arabic: Grammar & Morphology",
|
||||
"author": "Sh. Muhammad Al-Idrisi",
|
||||
"description": "An advanced course on the grammar (nahw) and morphology (sarf) of Classical Arabic as used in the Quran. Students will learn to analyze Quranic verses grammatically and understand the precise meanings conveyed through verb forms, cases, and sentence structures.",
|
||||
"imageUrl": "/images/courses/quranic-arabic.jpg",
|
||||
"moduleCount": 4,
|
||||
"totalMinutes": 60,
|
||||
"difficulty": "advanced",
|
||||
"giteaPath": "courses/quranic-arabic-grammar",
|
||||
"priceFlh": null,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": true,
|
||||
"published": true,
|
||||
"createdAt": "2026-06-10T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-25T16:00:00.000Z",
|
||||
"modules": [
|
||||
{
|
||||
"id": "clx4a1b2c0012qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0011qrstuvwxyz01",
|
||||
"order": 1,
|
||||
"title": "Introduction to Arabic Grammar (Nahw)",
|
||||
"slug": "intro-arabic-grammar-nahw",
|
||||
"keyTakeaway": "Arabic sentences are either nominal (jumla ismiyyah) or verbal (jumla fi'liyyah). Understanding the three parts of speech — noun, verb, particle — is the foundation of nahw.",
|
||||
"duration": 15,
|
||||
"content": "## Introduction to Arabic Grammar (Nahw)\n\n### The Three Parts of Speech\n\n1. **Ism (Noun/اسم)** — A word that has meaning in itself without being tied to time.\n - Examples: رجل (man), كتاب (book), مسجد (mosque)\n - Includes pronouns, adjectives, and proper nouns\n\n2. **Fi'l (Verb/فعل)** — An action linked to a time.\n - ماضي (past): كتب (he wrote)\n - مضارع (present/future): يكتب (he writes/will write)\n - أمر (command): اكتب (write!)\n\n3. **Harf (Particle/حرف)** — A word with no meaning by itself.\n - Examples: في (in), على (on), من (from), هل (question particle)\n\n### Nominal vs. Verbal Sentences\n\n**Nominal Sentence (جملة اسمية)**\n- Begins with a noun\n- Has two parts: مبتدأ (subject/topic) + خبر (predicate)\n- Example: البيتُ كبيرٌ (The house is big)\n- Both are in nominative case (رفع)\n\n**Verbal Sentence (جملة فعلية)**\n- Begins with a verb\n- Has three parts: فعل (verb) + فاعل (subject/doer) + مفعول به (object) — optional\n- Example: كتبَ الطالبُ الدرسَ (The student wrote the lesson)\n\n### I'rab (Case Endings)\n- **Nominative (الرفع)** — Default case for subjects — marked by dammah (ـُ)\n- **Accusative (النصب)** — Objects and certain particles — marked by fatha (ـَ)\n- **Genitive (الجر)** — After prepositions and possession — marked by kasra (ـِ)\n\n> **Key insight:** A single dammah vs. fatha changes the entire grammatical role of a word in the verse. This is why nahw is essential for understanding the Quran.",
|
||||
"audioPath": "/audio/learn/quranic-arabic-grammar/module-01.mp3",
|
||||
"quizData": "[{\"question\":\"What are the three parts of speech in Arabic?\",\"options\":[\"Noun, verb, adjective\",\"Noun, verb, particle\",\"Subject, verb, object\",\"Past, present, command\"],\"correctIndex\":1},{\"question\":\"A nominal sentence (jumlah ismiyyah) begins with:\",\"options\":[\"A verb\",\"A particle\",\"A noun\",\"An adverb\"],\"correctIndex\":2},{\"question\":\"Which case ending (i'rab) marks the subject (fa'il) of a verb?\",\"options\":[\"Nominative (raf') with dammah\",\"Accusative (nasb) with fatha\",\"Genitive (jarr) with kasra\",\"Jussive (jazm) with sukun\"],\"correctIndex\":0},{\"question\":\"In the sentence 'كتبَ الطالبُ الدرسَ', what case is 'الدرسَ'?\",\"options\":[\"Nominative\",\"Accusative\",\"Genitive\",\"Jussive\"],\"correctIndex\":1}]",
|
||||
"createdAt": "2026-06-10T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-18T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0013qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0011qrstuvwxyz01",
|
||||
"order": 2,
|
||||
"title": "Verb Morphology (Sarf): The Root System",
|
||||
"slug": "verb-morphology-sarf-root-system",
|
||||
"keyTakeaway": "Classical Arabic verbs are built on a three-consonant root system. Changing the pattern (wazn) changes the meaning systematically — this is sarf.",
|
||||
"duration": 15,
|
||||
"content": "## Verb Morphology (Sarf): The Root System\n\n### The Arabic Root System\n\nAlmost every word in Arabic derives from a **three-consonant root** (جذر ثلاثي). The root carries the core meaning, and various patterns (أوزان) are applied to create related words.\n\n**Example: Root ك-ت-ب (k-t-b) — Writing**\n\n| Pattern | Word | Meaning |\n|---------|------|---------|\n| فَعَلَ | كَتَبَ | He wrote |\n| فاعَلَ | كاتَبَ | He corresponded |\n| أفعَلَ | أكتَبَ | He dictated |\n| تَفَعَّلَ | تَكَتَّبَ | He wrote to each other |\n| اِفتَعَلَ | اِكتَتَبَ | He copied / registered |\n| مَفعَلٌ | مَكتَبٌ | Office / desk |\n| فاعِلٌ | كاتِبٌ | Writer (subject noun) |\n| مَفعُولٌ | مَكتوبٌ | Written (object noun) |\n\n### The Ten Standard Verb Forms (الأوزان العشرة)\n\n1. **فَعَلَ** — Base form (e.g., نَصَرَ — he helped)\n2. **فَعَّلَ** — Intensification (e.g., كَسَّرَ — he smashed)\n3. **فاعَلَ** — Mutual action (e.g., ضارَبَ — he fought)\n4. **أفعَلَ** — Causative (e.g., أكرَمَ — he honored)\n5. **تَفَعَّلَ** — Reflexive (e.g., تَعَلَّمَ — he learned)\n6. **تَفاعَلَ** — Mutual/reciprocal (e.g., تَقاتَلَ — they fought each other)\n7. **اِنفَعَلَ** — Passive (e.g., اِنكَسَرَ — it broke)\n8. **اِفتَعَلَ** — Reflective/self (e.g., اِجتَهَدَ — he strived)\n9. **اِفعَلَّ** — Colors/defects (e.g., اِحمَرَّ — it turned red)\n10. **اِستَفعَلَ** — Request/estimation (e.g., اِستَغفَرَ — he asked for forgiveness)\n\n> **Quranic example:** The root ر-ح-م (mercy) appears across multiple forms: رحمة (mercy), رحيم (merciful), رحمن (the Most Merciful), استرحم (he begged for mercy).",
|
||||
"audioPath": "/audio/learn/quranic-arabic-grammar/module-02.mp3",
|
||||
"quizData": "[{\"question\":\"Most Arabic words are built on how many consonant letters?\",\"options\":[\"Two\",\"Three\",\"Four\",\"Five\"],\"correctIndex\":1},{\"question\":\"Verb Form IV (أفعَلَ) generally indicates what?\",\"options\":[\"Intensification\",\"Mutual action\",\"Causative\",\"Passive\"],\"correctIndex\":2},{\"question\":\"Form VIII (اِفتَعَلَ) is often used for:\",\"options\":[\"Colors and defects\",\"Reflective/self-action\",\"Mutual action\",\"Requesting something\"],\"correctIndex\":1},{\"question\":\"What is the Form X (اِستَفعَلَ) of 'to forgive' (غفر)?\",\"options\":[\"غَفَرَ\",\"غَفَّرَ\",\"اِستَغفَرَ\",\"تَغَفَّرَ\"],\"correctIndex\":2}]",
|
||||
"createdAt": "2026-06-11T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-18T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0014qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0011qrstuvwxyz01",
|
||||
"order": 3,
|
||||
"title": "Analyzing Quranic Verses Grammatically",
|
||||
"slug": "analyzing-quranic-verses",
|
||||
"keyTakeaway": "Every word in the Quran carries grammatical markers that unlock precise meaning. A single change in i'rab can alter the theological implication of an ayah.",
|
||||
"duration": 20,
|
||||
"content": "## Analyzing Quranic Verses Grammatically\n\n### Example 1: Ayat al-Kursi (2:255)\n\n> **اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ الْحَيُّ الْقَيُّومُ**\n\n- **اللَّهُ** — Subject (مبتدأ), nominative case\n- **لَا إِلَٰهَ** — لَا النافية للجنس (لا of negation) + its noun in accusative\n- **إِلَّا** — Particle of exception\n- **هُوَ** — Substitute in place of the predicate\n- **الْحَيُّ الْقَيُّومُ** — Two adjectives of Allah, nominative\n\n### Example 2: Bismillah (1:1)\n\n> **بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ**\n\n- **بِ** — Preposition (حرف جر)\n- **سْمِ** — Noun, genitive case due to preposition\n- **اللَّهِ** — Possessive/noun in genitive (مضاف إليه)\n- **الرَّحْمَٰنِ** — First adjective, genitive following the noun\n- **الرَّحِيمِ** — Second adjective, genitive\n\n### Example 3: Key Grammatical Features in the Quran\n\n1. **إعراب (I'rab)** — Case endings that determine meaning\n - إِيَّاكَ نَعْبُدُ — \"You alone we worship\" (object pronoun placed before verb for emphasis)\n2. **التقديم والتأخير (Fronting and delaying)** — Changes emphasis\n - إِنَّمَا يَخْشَى اللَّهَ مِنْ عِبَادِهِ الْعُلَمَاءُ — The subject is delayed for emphasis\n3. **الحذف (Ellipsis)** — Words are omitted for conciseness\n - وَلَا يُفْلِحُ الْكَافِرُونَ — The implicit \"indeed\" (قَدْ) is understood\n4. **الضمير (Pronouns)** — Often refer back to Allah in ambiguous ways for tawhid emphasis\n\n> **Benefit:** Understanding nahw allows you to see why scholars derive different rulings from the same verse — often it hinges on a single grammatical analysis.",
|
||||
"audioPath": "/audio/learn/quranic-arabic-grammar/module-03.mp3",
|
||||
"quizData": "[{\"question\": \"In 'بِسْمِ اللَّهِ', the word 'اللَّهِ' is in which grammatical case?\", \"options\": [\"Nominative\", \"Accusative\", \"Genitive\", \"Jussive\"], \"correctIndex\": 2}, {\"question\": \"In 'إِيَّاكَ نَعْبُدُ', the fronting of 'إِيَّاكَ' before the verb indicates:\", \"options\": [\"Negation\", \"Emphasis/exclusivity\", \"Question\", \"Condition\"], \"correctIndex\": 1}, {\"question\": \"'الرَّحْمَٰنِ' in the basmalah is grammatically what?\", \"options\": [\"A verb\", \"A predicate\", \"An adjective following the noun\", \"An object\"], \"correctIndex\": 2}, {\"question\": \"لا إِلَٰهَ إِلَّا اللَّهُ — what grammatical construction is 'لا إِلَٰهَ'?\", \"options\": [\"Negative verb\", \"لا of generic negation\", \"Prohibition\", \"Relative clause\"], \"correctIndex\": 1}]",
|
||||
"createdAt": "2026-06-12T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-18T10:00:00.000Z"
|
||||
},
|
||||
{
|
||||
"id": "clx4a1b2c0015qrstuvwxyz01",
|
||||
"courseId": "clx4a1b2c0011qrstuvwxyz01",
|
||||
"order": 4,
|
||||
"title": "Rhetoric (Balaaghah) & Quranic Style",
|
||||
"slug": "rhetoric-balaaghah-quranic-style",
|
||||
"keyTakeaway": "Balaaghah is the science of eloquence. The Quran is the ultimate example of Arabic eloquence, and studying its rhetorical devices deepens both appreciation and understanding.",
|
||||
"duration": 10,
|
||||
"content": "## Rhetoric (Balaaghah) & Quranic Style\n\nBalaaghah (بلاغة) is divided into three sciences:\n\n### 1. 'Ilm al-Ma'ani (علم المعاني) — The study of sentence construction\nFocuses on how the structure of a sentence affects its meaning.\n\n- **Khabar vs. Insha'** — Statements vs. requests\n- **Qasr (Restriction)** — Restricting something to another (e.g., إِيَّاكَ نَعْبُدُ = You ALONE we worship)\n- **Ijaaz (Brevity) vs. Itnaab (Elaboration)** — When to be concise vs. detailed\n\n### 2. 'Ilm al-Bayan (علم البيان) — The study of figurative language\n- **Tashbih (Simile)** — Explicit comparison using كَ (like) or كَأَنَّ (as if)\n - Example: \"He is like a donkey carrying books\" (62:5)\n- **Isti'arah (Metaphor)** — Implicit comparison\n - Example: \"They have hearts but do not understand\" (7:179) — heart as seat of understanding\n- **Kinaayah (Metonymy)** — Indirect reference\n - Example: \"And lower your wing to the believers\" (15:88) — be humble\n\n### 3. 'Ilm al-Badi' (علم البديع) — The study of rhetorical embellishments\n- **Jinas (Paronomasia/Punning)** — Using the same root in different forms\n - Example: \"When the earth is shaken with its shake\" (99:1) — زِلْزَالَ vs زَلْزَلَت\n- **Tibaq (Antithesis)** — Juxtaposition of opposites\n - Example: \"And that He causes to laugh and causes to weep\" (53:43)\n- **Mura'ah al-Nazir (Congruence)** — Mentioning related concepts together\n\n### Why Balaaghah Matters for Quranic Understanding\n\nMany objections to the Quran from non-Arabic speakers arise because they miss the rhetorical layers. For example, the seemingly repetitive verses in the Quran are actually masterclasses in emphasis, variation, and audience awareness.\n\n> **The challenge of the Quran:** \"And if you are in doubt about what We have revealed to Our servant, then produce a surah like it...\" (2:23) — the inimitability (**I'jaz**) of the Quran lies partly in its unmatched balaaghah.",
|
||||
"audioPath": "/audio/learn/quranic-arabic-grammar/module-04.mp3",
|
||||
"quizData": "[{\"question\":\"What does 'Ilm al-Bayan study?\",\"options\":[\"Sentence construction\",\"Figurative language and imagery\",\"Rhetorical embellishments\",\"Verb morphology\"],\"correctIndex\":1},{\"question\":\"The Quranic phrase 'lower your wing to the believers' is an example of:\",\"options\":[\"Simile (tashbih)\",\"Metaphor (isti'arah)\",\"Metonymy (kinaayah)\",\"Antithesis (tibaq)\"],\"correctIndex\":2},{\"question\":\"إِيَّاكَ نَعْبُدُ is an example of which rhetorical device?\",\"options\":[\"Simile\",\"Restriction (qasr)\",\"Punning (jinas)\",\"Elaboration (itnaab)\"],\"correctIndex\":1},{\"question\":\"The inimitability of the Quran is known as:\",\"options\":[\"Balaaghah\",\"I'jaz\",\"Nahw\",\"Sarf\"],\"correctIndex\":1}]",
|
||||
"createdAt": "2026-06-13T08:00:00.000Z",
|
||||
"updatedAt": "2026-06-18T10:00:00.000Z"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"slug": "daily-fiqh-beginner",
|
||||
"title": "Daily Fiqh for Beginners",
|
||||
"author": "FalahMobile Learning",
|
||||
"description": "Essential rulings for everyday Muslim life — from waking up to going to bed. Short lessons you can listen to during your commute or while making breakfast.",
|
||||
"imageUrl": "/images/courses/daily-fiqh-beginner.jpg",
|
||||
"difficulty": "beginner",
|
||||
"giteaPath": "courses/daily-fiqh-beginner",
|
||||
"priceFlh": null,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": false,
|
||||
"published": true,
|
||||
"modules": [
|
||||
{
|
||||
"order": 1,
|
||||
"title": "The Intention of Wudu",
|
||||
"slug": "intention-of-wudu",
|
||||
"keyTakeaway": "Wudu only counts if you intend it. The intention is the aim of the heart, not words on the tongue.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/daily-fiqh-beginner/module-01.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Where does the intention for wudu need to be made?",
|
||||
"options": [
|
||||
"Before touching water",
|
||||
"While washing the face",
|
||||
"After finishing wudu",
|
||||
"Loudly, so others can hear"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The intention must exist when you begin washing your face, the first act of wudu. It lives in the heart, not on the tongue."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nWudu is not just washing body parts — it is a spiritual reset. The Prophet ﷺ said, \"When a Muslim performs wudu and washes his face, every sin he committed with his eyes is washed away. When he washes his hands, every sin committed with his hands is washed away.\" (Sahih Muslim 244)\n\nBut wudu only counts if you **intend** it. The intention is the invisible thread that transforms a shower into worship.\n\n## 📖 Details\n\n**What is the intention?**\n\nIt is simply knowing in your heart: *I am doing this to purify myself for prayer, or to remove ritual impurity.* You do not need to speak it aloud. The scholars say the intention is \"the aim of the heart.\"\n\n**When to make it:**\n\nThe intention must exist when you begin washing your face — the first act of wudu. If you start washing and then remember, \"Oh, I should make wudu,\" it counts as long as you intended it before finishing.\n\n**Common mistake:**\n\nSome people say \"Bismillah\" and assume that is the intention. Bismillah is recommended, but it is not the intention itself. The intention lives in the heart, not on the tongue.\n\n## 🤔 Reflection\n\nThink about your last wudu. Were you rushing through it while mentally scrolling your to-do list? What if you paused at the tap and thought: *This water is washing away more than dust — it is washing away mistakes?*\n\n## ⚡ Action Step\n\nBefore your next prayer, stand at the sink for five seconds. Say silently: *I intend wudu to purify myself for prayer.* Feel the intention settle. Then begin.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Fiqh us-Sunnah (Sayyid Sabiq)*"
|
||||
},
|
||||
{
|
||||
"order": 2,
|
||||
"title": "How to Perform Wudu Step by Step",
|
||||
"slug": "how-to-perform-wudu",
|
||||
"keyTakeaway": "Four acts in order: face, arms, head, feet. Each with tranquility. The Quran describes wudu with elegant precision.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/daily-fiqh-beginner/module-02.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "How many essential steps (pillars) does salah have?",
|
||||
"options": [
|
||||
"5",
|
||||
"7",
|
||||
"10",
|
||||
"14"
|
||||
],
|
||||
"correctIndex": 3,
|
||||
"explanation": "Salah has 14 pillars (arkan). Missing any one intentionally invalidates the prayer."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nAllah describes wudu in the Quran with elegant precision: \"Wash your faces, your hands to the elbows, wipe your heads, and wash your feet to the ankles.\" (5:6). Four acts, in order, done mindfully.\n\n## 📖 Details\n\n**Step 1: Face**\nWash from the hairline to the chin, and from ear to ear. The water must touch the skin. If you have a thick beard, run your wet fingers through it. The Prophet ﷺ did this.\n\n**Step 2: Arms to Elbows**\nWash from fingertips to elbows. Start with the right arm, then the left. Some scholars say order is recommended, not mandatory — but following the Sunnah brings barakah.\n\n**Step 3: Head**\nWipe the head with wet hands, from front to back and back to front. You only need to touch the hair or scalp. A single wipe is enough.\n\n**Step 4: Ears**\nWipe the inside and back of the ears with your wet index fingers and thumbs. The Prophet ﷺ said, \"The ears are part of the head.\" (Sunan Abi Dawud 111)\n\n**Step 5: Feet to Ankles**\nWash the feet, including between the toes, up to the ankle bone. Start right, then left.\n\n**What to say:**\nBismillah before starting. After finishing, the Prophet ﷺ would say: \"Ashhadu an la ilaha ill-Allah wahdahu la sharika lah, wa ashhadu anna Muhammadan abduhu wa rasuluh\" — bearing witness to the Oneness of Allah and the prophethood of Muhammad.\n\n## 🤔 Reflection\n\nWudu takes about two minutes. Yet it washes away sins and prepares you to stand before Allah. Compare that to the time you spend on social media. What if wudu became your favorite two minutes of the day?\n\n## ⚡ Action Step\n\nPerform wudu now, even if you do not need to pray immediately. Pay attention to every limb. Do not rush. Notice how your heart slows down.\n\n---\n\n*Sources: Quran 5:6, Sahih al-Bukhari, Sunan Abi Dawud*"
|
||||
},
|
||||
{
|
||||
"order": 3,
|
||||
"title": "When Wudu Breaks",
|
||||
"slug": "when-wudu-breaks",
|
||||
"keyTakeaway": "Eight things break wudu. If you are unsure, assume you did not break it. Build on certainty, not suspicion.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/daily-fiqh-beginner/module-03.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "If you are unsure whether you broke wudu, what should you assume?",
|
||||
"options": [
|
||||
"Assume you broke it and make wudu again",
|
||||
"Assume you did not break it and continue",
|
||||
"Ask a friend what they think",
|
||||
"Skip prayer to be safe"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The Prophet taught: build on certainty, not suspicion. If you are unsure, assume your wudu is still valid."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nWudu is a fragile state. The Prophet ﷺ described it as light on the face that fades when something breaks it. Knowing what breaks wudu saves you from praying in an invalid state — which is like building a house on sand.\n\n## 📖 Details\n\n**The eight things that break wudu:**\n\n1. **Anything exiting the front or back passage** — urine, stool, gas, or any other substance\n2. **Deep sleep** — if you lose awareness while lying down\n3. **Loss of consciousness** — fainting, intoxication, or anesthesia\n4. **Touching the private parts** — with the palm or inner fingers\n5. **Touching another's private parts** — with desire\n6. **Eating camel meat** — a specific ruling for camel\n7. **Apostasy** — leaving Islam (Allah forbid)\n8. **Blood or pus** — flowing from the body (minority view, but worth knowing)\n\n**What does NOT break wudu:**\n\n- Touching a non-mahram (the Prophet ﷺ shook hands with women)\n- Kissing your spouse (with or without desire)\n- Bleeding from a small cut\n- Vomiting\n- Laughing loudly in prayer (this breaks the prayer, not the wudu)\n- Doubting whether you broke wudu — certainty is required\n\n**The doubt rule:**\nIf you are unsure whether you broke wudu, assume you did not. The Prophet ﷺ said, \"If one of you feels something in his stomach and is unsure whether something came out, he should not leave the mosque unless he hears a sound or smells an odor.\" (Sahih Muslim 550)\n\n## 🤔 Reflection\n\nMany Muslims anxiously question their wudu status. How many prayers have been delayed by unnecessary doubt? The Sunnah teaches: build on certainty, not suspicion. Are you overthinking your purity?\n\n## ⚡ Action Step\n\nMake a mental note of the doubt rule. Next time you wonder, \"Did I break wudu?\" — if you are not sure, you did not. Proceed with confidence.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 4,
|
||||
"title": "The Call to Prayer",
|
||||
"slug": "the-call-to-prayer",
|
||||
"keyTakeaway": "The adhan is an invitation from Allah. Repeat after the muezzin, send blessings on the Prophet, and make dua.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/daily-fiqh-beginner/module-04.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "What should you do immediately after hearing the adhan?",
|
||||
"options": [
|
||||
"Rush to the prayer mat",
|
||||
"Repeat what the muezzin says",
|
||||
"Start eating if you were about to break your fast",
|
||||
"Change into clean clothes"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The Sunnah is to repeat after the muezzin silently, then send blessings on the Prophet, and finally make dua."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nThe adhan is more than a reminder — it is an invitation from Allah. When you hear it, you are being personally called to success. The Prophet ﷺ said, \"When you hear the muezzin, repeat what he says, then invoke blessings on me.\" (Sahih Muslim 384)\n\n## 📖 Details\n\n**What to do when you hear the adhan:**\n\n1. **Repeat after the muezzin** — silently or softly, phrase by phrase\n2. **Send blessings on the Prophet ﷺ** after the muezzin finishes\n3. **Ask for the wasilah** — the highest level of Paradise\n4. **Make dua** — your supplication between adhan and iqamah is not rejected\n\n**The exact dua:**\n\nAfter sending blessings on the Prophet ﷺ, say:\n> *Allahumma Rabba hadhihid-da'watit-tammah, was-salatil-qa'imah, ati Muhammadanil-wasilata wal-fadhilah, wab'athu maqaman mahmuda nilladhi wa'adtah.*\n\n(O Allah, Lord of this perfect call and established prayer, grant Muhammad the wasilah and virtue, and raise him to the praised station You promised him.)\n\n**After the adhan:**\n\nDo not rush. The time between adhan and iqamah is precious. Use it for:\n- Dua (supplication)\n- Optional prayer (rawatib/sunna prayers)\n- Quiet preparation\n\n**Modern challenge:**\n\nMany of us hear the adhan on our phones rather than from a mosque. The same rules apply. Pause. Respond. Let the call interrupt your day intentionally.\n\n## 🤔 Reflection\n\nThe adhan interrupts work, sleep, conversation, and entertainment — on purpose. It is a scheduled disruption designed to reorient your heart. Do you treat it as an annoyance or an invitation? What would change if you stopped everything for 60 seconds when you heard it?\n\n## ⚡ Action Step\n\nSet your phone's adhan notification to a voice you love, not a jarring beep. For the next three adhans, stop what you are doing, repeat the words, and make one sincere dua before the iqamah.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Nasa'i*"
|
||||
},
|
||||
{
|
||||
"order": 5,
|
||||
"title": "The Essentials of Salah",
|
||||
"slug": "essentials-of-salah",
|
||||
"keyTakeaway": "Salah has 14 pillars. Missing any intentionally invalidates the prayer. Tranquility over speed.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/daily-fiqh-beginner/module-05.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Which surah must be recited in every rak'ah of every prayer?",
|
||||
"options": [
|
||||
"Surah al-Ikhlas",
|
||||
"Surah al-Fatiha",
|
||||
"Surah al-Baqarah",
|
||||
"Any surah the worshipper chooses"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "Reciting al-Fatiha is a pillar of every rak'ah. The Prophet said, 'There is no prayer for the one who does not recite the Opening of the Book.'"
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nSalah is the backbone of a Muslim's day. The Prophet ﷺ said, \"The first matter that the slave will be brought to account for on the Day of Judgment is the prayer. If it is sound, the rest of his deeds will be sound. If it is corrupt, the rest of his deeds will be corrupt.\" (Sunan al-Tirmidhi 413)\n\nSalah has **14 pillars (arkan)**. Missing any one intentionally invalidates the prayer. Missing it by forgetfulness requires the forgetfulness prostration (sujud as-sahw) at the end.\n\n## 📖 Details\n\n**The 14 Pillars of Salah:**\n\n**Before Salah:**\n1. **Standing** (if able) — for obligatory prayers\n2. **The opening takbir** — saying *Allahu Akbar* to begin\n3. **Reciting al-Fatiha** — in every rak'ah of every prayer\n4. **Bowing (ruku)** — with tranquility\n5. **Rising from ruku** — with tranquility\n6. **Prostration (sujud)** — forehead, nose, hands, knees, and toes touching the ground\n7. **Sitting between prostrations** — with tranquility\n8. **The final tashahhud** — the testimony after the last sitting\n9. **Sitting for the final tashahhud** — with tranquility\n10. **The taslim** — saying *As-salamu alaykum* to end the prayer\n\n**During the prayer:**\n11. **Order** — the pillars must be performed in sequence\n12. **Tranquility (tuma'ninah)** — each position must be still for a moment\n13. **Intention** — knowing which prayer you are performing\n14. **Facing the qibla** — toward the Ka'bah in Makkah\n\n**The Forgetfulness Prostration:**\n\nIf you accidentally miss a pillar (like skipping a ruku or adding an extra rak'ah), prostrate twice *before* the taslim and say: *Subhana Rabbiyal-A'la* (Glory be to my Lord, the Most High).\n\n## 🤔 Reflection\n\nMany Muslims pray quickly, rushing through positions like a checklist. The Prophet ﷺ prayed so slowly that a companion said, \"I wanted to do something bad but remembered I was in prayer.\" (Sahih Muslim 543) What if your prayer was so present that it stopped you from sinning?\n\n## ⚡ Action Step\n\nIn your next prayer, add one extra second to each position. Feel your weight in ruku. Feel the ground beneath your forehead in sujud. Notice your breathing slow. That one second is the difference between a transaction and a conversation.\n\n---\n\n*Sources: Quran 2:238, Sahih al-Bukhari, Sahih Muslim, Sunan al-Tirmidhi*"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"slug": "ramadan-fasting-essentials",
|
||||
"title": "Ramadan & Fasting Essentials",
|
||||
"author": "FalahMobile Learning",
|
||||
"description": "Everything a beginner needs to know about fasting in Ramadan — from the intention and suhoor to what breaks the fast, who is exempt, and how to catch Laylat al-Qadr.",
|
||||
"imageUrl": "/images/courses/ramadan-fasting.jpg",
|
||||
"difficulty": "beginner",
|
||||
"giteaPath": "courses/ramadan-fasting-essentials",
|
||||
"priceFlh": null,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": false,
|
||||
"published": true,
|
||||
"modules": [
|
||||
{
|
||||
"order": 1,
|
||||
"title": "The Meaning & Virtue of Fasting",
|
||||
"slug": "meaning-virtue-fasting",
|
||||
"keyTakeaway": "Fasting is the fourth pillar of Islam. It is not merely abstaining from food — it is a shield that protects from sin and draws the believer closer to Allah.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/ramadan-fasting-essentials/module-01.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "What is the primary spiritual purpose of fasting beyond abstaining from food?",
|
||||
"options": [
|
||||
"To lose weight",
|
||||
"To train the soul in taqwa (God-consciousness)",
|
||||
"To save money on groceries",
|
||||
"To prepare for the Day of Judgment only"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "Allah says: 'Fasting is prescribed upon you as it was prescribed upon those before you, that you may attain taqwa.' (2:183). The core purpose is cultivating God-consciousness."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nFasting (Sawm) is the **fourth pillar of Islam**. Every Muslim who has reached puberty, is sane, and physically able must fast the month of Ramadan. But fasting is far more than skipping meals — it is a comprehensive spiritual reset.\n\nThe Prophet ﷺ said, \"Fasting is a shield. When one of you is fasting, let him not behave in an obscene manner nor raise his voice. If someone insults him or fights with him, let him say: 'I am fasting, I am fasting.'\" (Sahih al-Bukhari 1894)\n\n## 📖 Details\n\n**What fasting means linguistically:**\n\nSawm (صوم) means to abstain. In Islamic law, it means abstaining from food, drink, sexual intercourse, and anything entering the body through a normal pathway from true dawn (fajr) until sunset (maghrib), with the intention of worship.\n\n**The Quranic command:**\n\n> 'O you who believe, decreed upon you is fasting as it was decreed upon those before you, that you may become righteous.' (Quran 2:183)\n\n**Virtues specific to Ramadan:**\n- The gates of Paradise are opened\n- The gates of Hell are closed\n- The devils are chained\n- Every night, Allah frees people from the Hellfire\n\n**Beyond Ramadan:**\n\nFasting is also recommended on:\n- The six days of Shawwal (after Eid)\n- Mondays and Thursdays\n- The 13th, 14th, and 15th of each lunar month\n- The Day of Arafah (9th Dhul-Hijjah)\n- The Day of Ashura (10th Muharram)\n\n## 🤔 Reflection\n\nIf fasting were only about hunger, athletes would be the most pious people. But fasting is about the **soul's discipline over the body**. What area of your life needs that same discipline? Your tongue? Your screen time? Your anger? Ramadan is a training camp for the entire year.\n\n## ⚡ Action Step\n\nWrite down three habits you want to control this Ramadan — not just food-related, but speech, anger, or social media. Post the list where you will see it every morning at suhoor.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Tafsir Ibn Kathir*"
|
||||
},
|
||||
{
|
||||
"order": 2,
|
||||
"title": "The Intention & Suhoor",
|
||||
"slug": "intention-and-suhoor",
|
||||
"keyTakeaway": "The intention for fasting must be made before dawn. Suhoor is a blessed meal — the Prophet ﷺ called it the meal of the righteous.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/ramadan-fasting-essentials/module-02.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "When must the intention for fasting Ramadan be made?",
|
||||
"options": [
|
||||
"The night before before sleeping",
|
||||
"Before the time of Fajr begins",
|
||||
"After Dhuhr prayer",
|
||||
"Any time during the day"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The intention for an obligatory fast must be made before the time of Fajr (dawn) enters. For voluntary fasts, it can be made later if no food has been consumed."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nEvery act of worship in Islam requires intention (niyyah). Without it, fasting is merely starvation. The Prophet ﷺ said, \"Actions are judged by intentions.\" (Sahih al-Bukhari 1)\n\nFor Ramadan, the intention must be made **before the time of Fajr begins** — meaning before the first thread of light appears on the horizon. You do not need to verbalize it. Simply knowing in your heart that you are fasting tomorrow is sufficient.\n\n## 📖 Details\n\n**The Suhoor meal:**\n\nSuhoor is the pre-dawn meal eaten before the fast begins. The Prophet ﷺ said, \"Eat suhoor, for in suhoor there is blessing.\" (Sahih al-Bukhari 1923)\n\n- **Timing:** Eat until just before Fajr adhan. Stop when the first light appears.\n- **What to eat:** Complex carbohydrates (oats, dates), protein (eggs, yogurt), and plenty of water. Avoid fried and salty foods.\n- **The dua:** The Prophet ﷺ would say at suhoor: 'Al-barakatu fi 'a-immah' (Blessing is in the early morning meal).\n\n**Common mistakes with intention:**\n\n1. **Assuming the intention carries over:** You must renew the intention each night. The intention from last Ramadan does not count.\n2. **Verbalizing incorrectly:** Some say 'I intend to fast tomorrow.' But you are already IN today before dawn. The correct framing is simply: 'I am fasting today.'\n3. **Forgetting entirely:** If you wake up and eat without remembering it is Ramadan, then recall later in the day, your fast is valid because the general intention of Ramadan was present.\n\n**The Adhan and Fajr timing:**\n\nBe careful with calculation apps. The true dawn (al-fajr al-sadiq) is when the horizontal light spreads across the sky, not the vertical light. Many apps conflate this. When in doubt, stop eating 10-15 minutes before the stated Fajr time to be safe.\n\n## 🤔 Reflection\n\nHow often do you eat breakfast on autopilot? Suhoor is the one meal designed to be eaten with full consciousness. You are literally preparing to meet Allah. What if you treated every suhoor like a pre-flight safety briefing for your soul?\n\n## ⚡ Action Step\n\nSet your suhoor alarm 20 minutes before Fajr, not 5 minutes. Use those 20 minutes to eat slowly, drink water, and make one sincere dua before the adhan.\n\n---\n\n*Sources: Sahih al-Bukhari, Sunan Abi Dawud, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 3,
|
||||
"title": "What Breaks the Fast & Common Mistakes",
|
||||
"slug": "what-breaks-the-fast",
|
||||
"keyTakeaway": "Eating, drinking, and sexual intercourse intentionally break the fast. Mistakes like forgetting or eating without knowledge do not break it.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/ramadan-fasting-essentials/module-03.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "If someone eats while genuinely forgetting they are fasting, what is the ruling?",
|
||||
"options": [
|
||||
"The fast is broken and must be made up",
|
||||
"The fast is broken and requires kaffarah (expiation)",
|
||||
"The fast is still valid; they should continue",
|
||||
"They must fast an extra day as punishment"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "The Prophet ﷺ said: 'If somebody eats or drinks forgetfully while fasting, he should complete his fast, for what he has eaten or drunk has been given to him by Allah.' (Sahih al-Bukhari 1933)"
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nFasting is a contract between you and Allah. There are things that break this contract, and things that do not. The difference between an intentional violation and an accidental one is the difference between a broken fast and a preserved one.\n\nThe Prophet ﷺ said, \"Allah has excused for my ummah mistakes, forgetfulness, and what they are forced to do.\" (Ibn Majah 2045)\n\n## 📖 Details\n\n**Things that break the fast (if done intentionally):**\n\n1. **Eating or drinking** — anything that reaches the stomach through the mouth, nose, or throat\n2. **Sexual intercourse** — requires both making up the fast AND kaffarah (expiation: freeing a slave, or fasting 60 consecutive days, or feeding 60 poor people)\n3. **Voluntary vomiting** — if you induce it intentionally\n4. **Menstruation and postpartum bleeding** — a woman's fast is broken by the start of either; she makes up the days later\n\n**Things that do NOT break the fast:**\n\n1. **Eating or drinking by mistake or forgetfulness** — continue fasting\n2. **Unintentional vomiting** — continue fasting\n3. **Swallowing saliva** — normal and permissible\n4. **Using miswak or toothbrush** — permissible, but avoid swallowing toothpaste\n5. **Eye drops, ear drops, and skin creams** — do not break the fast\n6. **Injections (non-nutritional)** — vaccines, insulin, and medical injections are permissible\n7. **Nosebleed or bleeding from a cut** — does not break the fast\n8. **Wet dreams** — natural and does not break the fast; ghusl is required before Fajr for the fast to be valid\n\n**Gray areas:**\n\n- **Rinsing the mouth (madmadah):** Permissible, but avoid excessive gargling. If water is swallowed intentionally, it breaks the fast.\n- **Kissing and touching spouse:** Permissible if you can control yourself. If it leads to ejaculation, the fast is broken.\n- **Smoking:** Breaks the fast. Inhaling anything intentionally through the mouth that reaches the throat breaks the fast.\n\n**The forgetfulness rule:**\n\nIf you eat or drink forgetfully, you must stop immediately upon remembering. Do NOT continue eating 'because it is already broken.' It is NOT broken. The Prophet ﷺ said Allah fed you.\n\n## 🤔 Reflection\n\nMany Muslims live in anxiety about whether their fast is valid. \"Did I swallow water while rinsing? Did my gum bleed?\" The Sunnah teaches us mercy. Allah does not burden a soul beyond what it can bear. Are you being harder on yourself than Allah is?\n\n## ⚡ Action Step\n\nIf you accidentally eat or drink this Ramadan, say 'Alhamdulillah' and continue. Do not let Shaytan convince you to abandon the rest of the day. The fast is still valid.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Nasa'i, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 4,
|
||||
"title": "Who Is Exempt & How to Make Up Fasts",
|
||||
"slug": "exemptions-and-make-up",
|
||||
"keyTakeaway": "Illness, travel, pregnancy, breastfeeding, and old age are valid exemptions. Each category has specific rules for making up fasts or paying fidyah.",
|
||||
"duration": 2,
|
||||
"audioPath": "/audio/learn/ramadan-fasting-essentials/module-04.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "A pregnant woman fears fasting will harm her baby. What should she do?",
|
||||
"options": [
|
||||
"Fast anyway and trust Allah",
|
||||
"Break the fast and feed one poor person per day",
|
||||
"Break the fast and make up the days later; feeding is only if she cannot make up",
|
||||
"Skip Ramadan entirely with no make-up"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "Pregnant and breastfeeding women who fear harm may break the fast. They must make up the days later. If they cannot make up (due to weakness or continuous pregnancy/nursing), they pay fidyah: feeding one poor person per day."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nAllah says: 'Allah intends for you ease and does not intend for you hardship.' (2:185). The Shari'ah is not a burden — it is a mercy. There are five categories of people excused from fasting, and each has a clear path forward.\n\n## 📖 Details\n\n**The five exemptions:**\n\n1. **The sick person**\n - If fasting will worsen the illness, delay recovery, or cause significant hardship, they are excused.\n - Must make up the days when healthy.\n - Chronic illness with no hope of recovery: pays fidyah (feeding one poor person per day).\n\n2. **The traveler**\n - Defined as a journey of approximately 80km+ one way, with the intention of staying less than 15 days.\n - The traveler MAY fast or break the fast — both are permitted.\n - If breaking, must make up later.\n - The Prophet ﷺ would sometimes fast while traveling and sometimes break the fast, showing flexibility.\n\n3. **The pregnant woman**\n - If fasting causes harm to herself or the baby, she breaks the fast.\n - Must make up the days later.\n - If unable to make up (due to continuous pregnancies or weakness), pays fidyah.\n\n4. **The breastfeeding woman**\n - Same ruling as pregnant: break if harm is feared, make up later, or pay fidyah if making up is not possible.\n\n5. **The elderly or permanently weak**\n - If unable to fast due to old age or chronic weakness with no hope of recovery, pays fidyah.\n - No need to make up — the inability is permanent.\n\n**Fidyah details:**\n\nFidyah means feeding one poor person for each day missed. The classical amount is half a saa' of the local staple food per day — approximately 1.5 kg of wheat, rice, or dates. In modern terms, this is roughly the cost of one meal in your local area.\n\n**Making up missed fasts (qada):**\n\n- Must be done before the next Ramadan\n- Can be done on any day except the two Eids and the days of Tashreeq (11th-13th Dhul-Hijjah)\n- Recommended to make up quickly rather than delaying\n- Can be combined with the six days of Shawwal for double reward\n\n## 🤔 Reflection\n\nSome Muslims feel guilty for breaking a fast due to legitimate exemption. But guilt is from Shaytan when the excuse is valid. The Prophet ﷺ said, 'Allah loves that His concessions be taken just as He hates that His commands be disobeyed.' (Sunan al-Bayhaqi) Have you been accepting Allah's mercy, or rejecting it through false guilt?\n\n## ⚡ Action Step\n\nIf you have missed fasts from previous Ramadan, count them now. Schedule one make-up fast per week. Add it to your calendar like an important meeting — because it is an appointment with Allah.\n\n---\n\n*Sources: Quran 2:184-185, Sahih al-Bukhari, Sahih Muslim, Sunan al-Tirmidhi*"
|
||||
},
|
||||
{
|
||||
"order": 5,
|
||||
"title": "Laylat al-Qadr & The Last Ten Nights",
|
||||
"slug": "laylat-al-qadr",
|
||||
"keyTakeaway": "Laylat al-Qadr is better than 1,000 months of worship. It is most likely in the last ten nights, and most probable on the odd nights among them.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/ramadan-fasting-essentials/module-05.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Which night is Laylat al-Qadr most likely to fall on?",
|
||||
"options": [
|
||||
"The first night of Ramadan",
|
||||
"The 15th night of Ramadan",
|
||||
"The 27th night (most probable, but could be any odd night in the last ten)",
|
||||
"The night of Eid al-Fitr"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "The Prophet ﷺ said: 'Seek it in the last ten nights, and if one of you is too weak or unable, let him not miss the remaining seven.' The strongest opinion among scholars is the 27th, but it can be any odd night in the last ten."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nLaylat al-Qadr (the Night of Decree) is the crown jewel of Ramadan. It is the night the Quran was first revealed. A single night of sincere worship on Laylat al-Qadr is greater than worshipping for 1,000 months — approximately 83 years of continuous prayer, fasting, and charity.\n\nAllah says: 'The Night of Decree is better than a thousand months. The angels and the Spirit descend therein by permission of their Lord for every matter. Peace it is until the emergence of dawn.' (Quran 97:3-5)\n\n## 📖 Details\n\n**When to seek it:**\n\nThe Prophet ﷺ would tighten his belt in the last ten nights of Ramadan — meaning he would intensify his worship, stay up all night, and avoid marital relations. He said, 'Seek Laylat al-Qadr in the odd nights of the last ten nights of Ramadan.' (Sahih al-Bukhari 2017)\n\n**The odd nights:** 21st, 23rd, 25th, 27th, and 29th.\n- The **27th night** is the most probable based on multiple narrations and scholarly consensus.\n- However, the Sunnah is to seek it in ALL the last ten nights to ensure you do not miss it.\n\n**What to do on Laylat al-Qadr:**\n\n1. **Pray Qiyam al-Layl (Tahajjud)** — at least 11 rak'ahs: 4 + 4 + 3 (Witr)\n2. **Recite Quran** — especially Surah al-Qadr and Surah al-Baqarah\n3. **Make dua** — the Prophet ﷺ taught Aisha to say: 'Allahumma innaka 'afuwwun, tuhibbul 'afwa, fa'fu 'anni' (O Allah, You are Pardoning and love to pardon, so pardon me.)\n4. **Give charity** — every deed is multiplied\n5. **Perform i'tikaf (spiritual retreat)** — the Prophet ﷺ did this in the last ten nights every year until his death\n\n**Signs of Laylat al-Qadr:**\n\n1. It is a peaceful, serene night\n2. The temperature is mild (not too hot, not too cold)\n3. The sun rises the next morning weak and reddish, without rays\n4. There are no shooting stars that night (the devils are barred from eavesdropping)\n\n**Common mistakes:**\n\n- Only seeking the 27th and ignoring the other nights\n- Spending the night in social gatherings rather than worship\n- Sleeping through the pre-dawn hours\n- Not preparing physically — napping in the day so you can worship at night\n\n## 🤔 Reflection\n\nImagine being offered a lottery ticket with 83 years of guaranteed reward. You would not sleep that night. Laylat al-Qadr is that ticket, but it requires your presence. Where will you be on the 27th night — scrolling reels, or prostrating before your Lord?\n\n## ⚡ Action Step\n\nBlock the last ten nights on your calendar NOW. Arrange work, childcare, and obligations so you can dedicate at least the odd nights to worship. Download a Quran app, prepare a dua list, and plan to give charity on each of those nights.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Tirmidhi, Tafsir al-Tabari*"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"slug": "zakat-made-simple",
|
||||
"title": "Zakat Made Simple",
|
||||
"author": "Ustadh Yusuf ibn Abdullah",
|
||||
"description": "A practical, step-by-step guide to calculating, paying, and understanding Zakat — the third pillar of Islam. Covers nisab thresholds, zakatable assets, the 8 categories of recipients, and modern financial instruments.",
|
||||
"imageUrl": "/images/courses/zakat-made-simple.jpg",
|
||||
"difficulty": "intermediate",
|
||||
"giteaPath": "courses/zakat-made-simple",
|
||||
"priceFlh": 300,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": false,
|
||||
"published": true,
|
||||
"modules": [
|
||||
{
|
||||
"order": 1,
|
||||
"title": "What Is Zakat & Why It Matters",
|
||||
"slug": "what-is-zakat",
|
||||
"keyTakeaway": "Zakat is the third pillar of Islam. It purifies wealth, redistributes surplus, and builds empathy between rich and poor.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/zakat-made-simple/module-01.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "What is the primary spiritual purpose of Zakat?",
|
||||
"options": [
|
||||
"To fund government projects",
|
||||
"To purify wealth and grow the soul through giving",
|
||||
"To reduce inflation",
|
||||
"To build mosques only"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The word Zakat comes from 'z-k-a' meaning growth and purification. The Prophet ﷺ said: 'Charity does not decrease wealth.' (Sahih Muslim 2588) It purifies the giver's heart from greed and the receiver's heart from envy."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nZakat is the **third pillar of Islam** after the Shahadah and Salah. It is not charity — it is a **mandatory tax on surplus wealth** that has been held for one lunar year. Every Muslim who owns wealth above a certain threshold (nisab) must pay 2.5% of that wealth annually.\n\nThe word Zakat comes from the Arabic root **z-k-a** meaning to grow, purify, and bless. Just as fire purifies gold by burning away impurities, Zakat purifies wealth by burning away greed. And just as pruning a tree causes it to grow stronger, giving Zakat causes your wealth to grow in barakah.\n\n## 📖 Details\n\n**The Quranic command:**\n\n> 'And establish prayer and give Zakat, and bow with those who bow.' (Quran 2:43)\n\nZakat is mentioned in the Quran **82 times** — almost always paired with Salah. This pairing shows that individual worship (Salah) and social responsibility (Zakat) are inseparable in Islam.\n\n**Why Zakat is mandatory, not optional:**\n\n1. **It is a pillar** — abandoning it without denial of its obligation is a major sin; denying its obligation entirely can affect one's Islam\n2. **It is a right of the poor** — the Quran calls Zakat 'a known right for the beggar and the deprived' (70:24-25)\n3. **It prevents hoarding** — wealth is a trust from Allah, not personal property to accumulate endlessly\n4. **It builds empathy** — the giver tastes the reality of dependence, and the receiver tastes dignity without humiliation\n\n**The psychological benefit:**\n\nModern research confirms what the Quran taught 1,400 years ago: giving increases happiness more than receiving. Zakat is not just economics — it is spiritual therapy. It cures the disease of materialism by forcing you to let go.\n\n**Zakat vs. Sadaqah:**\n\n| | Zakat | Sadaqah |\n|---|---|---|\n| Obligation | Mandatory | Voluntary |\n| Rate | Fixed (2.5% on most wealth) | Any amount |\n| Recipients | 8 specified categories | Anyone in need |\n| Minimum wealth | Nisab threshold required | No minimum |\n| Timing | Annual, once wealth matures | Any time |\n\n## 🤔 Reflection\n\nIf you own a smartphone, you likely possess enough wealth to owe Zakat. The question is not whether you can afford to give 2.5% — it is whether you can afford NOT to. The Prophet ﷺ warned that wealth not purified by Zakat will be heated in the Hellfire on the Day of Judgment and used to brand the hoarder. (Sahih Muslim 1015) What are you more attached to: your bank balance or your eternal safety?\n\n## ⚡ Action Step\n\nLog into your bank account right now and look at your savings. If you have held approximately $500 USD or more in cash/gold for one year, you may owe Zakat. Write the total down. We will calculate the exact amount in the next module.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Quran 2:43, 9:60, 70:24-25*"
|
||||
},
|
||||
{
|
||||
"order": 2,
|
||||
"title": "Nisab Threshold & When Zakat Is Due",
|
||||
"slug": "nisab-and-timing",
|
||||
"keyTakeaway": "Nisab is approximately 85g of gold or 595g of silver. Once you reach nisab and hold it for one lunar year, Zakat becomes due.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/zakat-made-simple/module-02.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "How long must you possess wealth above nisab before Zakat becomes obligatory?",
|
||||
"options": [
|
||||
"One Gregorian (solar) year",
|
||||
"One lunar (Hijri) year (354 days)",
|
||||
"Six months",
|
||||
"Immediately upon reaching nisab"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The haul (passage of time) for Zakat is one lunar year — approximately 354 days. This is calculated from the date you first possessed nisab, not the calendar year."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nNisab is the minimum threshold of wealth that makes Zakat obligatory. Think of it as the poverty line in reverse — it separates those who must give from those who are excused.\n\nThe Prophet ﷺ established nisab based on the value of precious metals because they were the most stable currencies of his time. Today, we convert those weights into modern currency.\n\n## 📖 Details\n\n**The two nisab standards:**\n\n| Metal | Weight | Modern Equivalent (approximate) |\n|---|---|---|\n| Gold | 85 grams | ~$7,500–$8,500 USD (varies with market) |\n| Silver | 595 grams | ~$500–$600 USD (varies with market) |\n\n**Which nisab to use?**\n\nScholars differ, but the majority of contemporary scholars recommend using the **silver nisab** because it includes more people in the obligation. The gold nisab is extremely high and would exempt most middle-class Muslims. The silver nisab aligns with the Prophet's intent that Zakat be broadly applicable.\n\n**The lunar year (haul):**\n\nOnce you possess nisab, you must track one full lunar year (354 days). Zakat becomes due on the anniversary of when you first reached nisab.\n\n**Example timeline:**\n\n- 1st Muharram 1447: You receive $10,000 and it stays in your account\n- 1st Muharram 1448: Zakat is due on the total zakatable wealth you hold on this date\n\n**What if wealth fluctuates during the year?**\n\n- If your wealth drops below nisab during the year and then rises again: the clock resets from the new date you reach nisab\n- If your wealth stays above nisab the entire year: Zakat is due on whatever you hold on the anniversary\n- If you receive new wealth during the year: add it to your total at the due date\n\n**Practical tip:**\n\nPick one date each year and make it your 'Zakat Day.' Many Muslims use the 1st of Ramadan or their birthday. The key is consistency. Write it in your calendar as a recurring event.\n\n**The moment of obligation:**\n\nZakat becomes due the moment the year completes, but you have grace to pay it. The Prophet ﷺ would send collectors immediately after Ramadan, suggesting the end of Ramadan as the natural settlement time. Delaying payment without excuse is discouraged.\n\n## 🤔 Reflection\n\nThe silver nisab (~$500) means most employed Muslims with any savings owe Zakat. Yet studies show that less than 25% of eligible Muslims worldwide pay it. Why? Usually because they do not know the threshold, or they avoid calculating because it makes the obligation real. Knowledge is responsibility — but it is also liberation.\n\n## ⚡ Action Step\n\nCalculate the current silver price per gram online. Multiply by 595g. Write your personal nisab number down. Then check your bank account: have you held more than this amount for a year? If yes, Zakat is due.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Fiqh us-Sunnah (Sayyid Sabiq), contemporary fiqh councils*"
|
||||
},
|
||||
{
|
||||
"order": 3,
|
||||
"title": "What Wealth Is Zakatable",
|
||||
"slug": "zakatable-wealth",
|
||||
"keyTakeaway": "Cash, gold, silver, business inventory, and investments are zakatable. Personal items, your home, car, and furniture are not.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/zakat-made-simple/module-03.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Which of the following is NOT subject to Zakat?",
|
||||
"options": [
|
||||
"Cash savings held for one year",
|
||||
"Gold jewelry you wear regularly",
|
||||
"Your primary home that you live in",
|
||||
"Stocks and shares in companies"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "Your primary residence, personal car, furniture, clothing, and tools of your trade are not zakatable. Zakat applies to surplus wealth held for growth or savings — not to items of daily use."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nNot everything you own is zakatable. Allah does not tax your necessities — He taxes your surplus. Understanding what counts and what does not prevents you from overpaying or underpaying.\n\nThe general rule: Zakat applies to **wealth held for growth or savings** that exceeds your immediate needs and has been held for one lunar year.\n\n## 📖 Details\n\n**Zakatable assets:**\n\n1. **Cash and bank balances** — all currencies, checking and savings accounts\n2. **Gold and silver** — jewelry, coins, bars (even if worn, according to the stronger opinion)\n3. **Business inventory** — goods held for resale at their current market value\n4. **Investments and stocks** — the zakatable portion depends on the company's assets\n5. **Loans you expect to be repaid** — add to your total if recovery is likely\n6. **Retirement accounts** — the accessible portion (if you can withdraw without severe penalty)\n7. **Cryptocurrency** — treated like cash if held as investment; market value at Zakat date\n8. **Rental income** — the accumulated savings from rent if held above nisab\n\n**Non-zakatable assets:**\n\n1. **Your primary home** — the house you live in\n2. **Personal vehicle** — one car for transportation\n3. **Furniture and household items** — fridge, TV, bed, clothes\n4. **Tools of your trade** — laptop for a developer, scalpel for a surgeon\n5. **Debt you owe** — subtract personal debts that are due now or soon from your total\n6. **Living expenses buffer** — one month's essential expenses can be deducted\n\n**Modern gray areas:**\n\n- **Second home or investment property:** The property itself is not zakatable, but the rental income saved is. If the property is held for resale, its market value is zakatable.\n- **Stocks:** If the company holds mostly cash/receivables, treat like cash. If it holds productive assets, some scholars say only the liquid portion is zakatable. A safe approach: pay 2.5% on the current market value of your shares.\n- **Pension funds:** If you cannot access the money now, many scholars say it is not yet zakatable. If you can access it, include it.\n- **Crypto:** Include at market value on your Zakat date. It is treated as a liquid asset.\n\n**The calculation formula:**\n\n```\nZakatable Wealth = (Cash + Gold + Silver + Investments + Business Inventory + Recoverable Loans) - (Immediate Debts + One Month Expenses)\n\nIf Zakatable Wealth ≥ Nisab:\n Zakat = Zakatable Wealth × 0.025\n```\n\n## 🤔 Reflection\n\nMany Muslims include their home and car in the calculation and feel overwhelmed. The Prophet ﷺ said, 'There is no Zakat on a man's slave or horse.' (Sahih Muslim 982) In modern terms: Allah does not tax your tools of living. Are you calculating out of fear (including everything) or out of precision (including only what the Shari'ah asks)?\n\n## ⚡ Action Step\n\nOpen a spreadsheet. List every zakatable asset you own. Then list your immediate debts. Subtract. Multiply the result by 0.025. That is your Zakat. If the total is above nisab, you owe it.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Fiqh us-Sunnah, Zakat Foundation fiqh guidelines*"
|
||||
},
|
||||
{
|
||||
"order": 4,
|
||||
"title": "Calculating Your Zakat Step by Step",
|
||||
"slug": "calculating-zakat",
|
||||
"keyTakeaway": "Add all zakatable assets, subtract immediate debts and one month's expenses, check if the remainder reaches nisab, then pay 2.5%.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/zakat-made-simple/module-04.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "If your zakatable wealth after deductions is $5,000 and nisab is $500, how much Zakat do you owe?",
|
||||
"options": [
|
||||
"$50 (1%)",
|
||||
"$125 (2.5%)",
|
||||
"$250 (5%)",
|
||||
"$500 (10%)"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The standard rate for cash, gold, silver, and trade goods is 2.5%. $5,000 × 0.025 = $125. This rate has been fixed since the time of the Prophet ﷺ."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nZakat calculation is simple arithmetic, but most Muslims avoid it because it forces them to confront their wealth honestly. This module is your calculator. Follow each step and you will know exactly what you owe.\n\n## 📖 Details\n\n**Step 1: Set your Zakat date**\n\nPick one day each year. This is the day you assess everything. Recommended: the 1st of Ramadan, or the anniversary of your first reaching nisab.\n\n**Step 2: List all zakatable assets (market value on your Zakat date)**\n\n| Asset | Example Amount |\n|---|---|\n| Cash in bank | $3,000 |\n| Cash in hand | $200 |\n| Gold jewelry (at market value) | $1,500 |\n| Silver | $100 |\n| Stocks/shares (current value) | $2,000 |\n| Business inventory for sale | $800 |\n| Money owed to you (likely to be repaid) | $500 |\n| Cryptocurrency (market value) | $300 |\n| **TOTAL ASSETS** | **$8,400** |\n\n**Step 3: List deductions**\n\n| Deduction | Example Amount |\n|---|---|\n| Personal debts due now | $1,000 |\n| One month's living expenses | $2,000 |\n| **TOTAL DEDUCTIONS** | **$3,000** |\n\n**Step 4: Calculate net zakatable wealth**\n\n$8,400 - $3,000 = **$5,400**\n\n**Step 5: Compare to nisab**\n\nIf your local silver nisab is $500: $5,400 > $500 → **Zakat is due.**\n\nIf your net wealth were $400: $400 < $500 → **No Zakat due.**\n\n**Step 6: Calculate Zakat amount**\n\n$5,400 × 0.025 (2.5%) = **$135**\n\nThat is your Zakat. It is approximately the cost of a nice dinner. For that amount, you fulfill a pillar of Islam and purify your entire year's wealth.\n\n**Special cases:**\n\n- **If you have multiple currencies:** Convert all to one currency at the exchange rate on your Zakat date.\n- **If your business inventory fluctuates:** Use the market value on your Zakat date, not what you paid.\n- **If you are in debt:** Only subtract debts that are due now or within the next year. Do not subtract your mortgage principal unless a lump sum is due immediately.\n- **If you have a joint account:** Count only your portion.\n\n**Paying in instalments:**\n\nWhile Zakat is due immediately upon completion of the year, scholars permit paying in instalments if doing so prevents hardship. However, the intention must be to pay the full amount, not to delay indefinitely.\n\n## 🤔 Reflection\n\nThe average Muslim who pays Zakat gives less than 1% of their actual wealth because they miscalculate. Some overpay and struggle. Some underpay and sin. Precision in Zakat is not stinginess — it is taqwa. The Prophet ﷺ was the most generous of people, yet he was precise in his obligations. Are you precise in yours?\n\n## ⚡ Action Step\n\nComplete the worksheet above with your real numbers. Do not estimate — check your bank apps, jewelry weight, and investment accounts. Write the final Zakat amount on a piece of paper and place it on your prayer mat. Pay it this week.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Fiqh us-Sunnah, NZF (National Zakat Foundation) calculator methodology*"
|
||||
},
|
||||
{
|
||||
"order": 5,
|
||||
"title": "The 8 Categories of Zakat Recipients",
|
||||
"slug": "eight-categories-recipients",
|
||||
"keyTakeaway": "The Quran specifies exactly 8 categories who may receive Zakat. Paying outside these categories invalidates your Zakat unless a legitimate shar'i reason exists.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/zakat-made-simple/module-05.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Which of the following CANNOT receive Zakat?",
|
||||
"options": [
|
||||
"A poor person with no income",
|
||||
"A new Muslim with strained family relations",
|
||||
"A wealthy person who is your parent or child",
|
||||
"Someone in debt who cannot repay"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "The Quran specifies 8 categories (9:60). Zakat cannot be given to one's parents, children, or wealthy individuals. It is meant for the poor, needy, indebted, and other specified categories."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nThe Quran does not leave Zakat distribution to guesswork. It names **eight specific categories** of people who are eligible to receive Zakat. Giving to anyone outside these categories is an act of charity (sadaqah), not Zakat — and does not fulfill your pillar obligation.\n\nAllah says: 'Zakat expenditures are only for the poor and the needy, and for those employed to collect it, and for bringing hearts together, and for freeing captives, and for the indebted, and for the cause of Allah, and for the stranded traveler — an obligation imposed by Allah. And Allah is Knowing and Wise.' (Quran 9:60)\n\n## 📖 Details\n\n**The eight categories explained:**\n\n1. **Al-Fuqara (The Poor)**\n - Those who own less than nisab and have no means of earning\n - Priority: those with absolutely nothing\n\n2. **Al-Masakin (The Needy)**\n - Those who own some wealth but it is insufficient for their basic needs\n - Slightly better off than the poor, but still in genuine need\n\n3. **Al-Amilina Alayha (Those Employed to Collect It)**\n - The administrators and distributors of Zakat funds\n - They receive a wage from the Zakat pool for their work\n\n4. **Al-Muallafati Qulubuhum (Those Whose Hearts Are to Be Reconciled)**\n - New Muslims or those near to Islam whose faith needs strengthening\n - Also applies to community leaders whose goodwill benefits Muslims\n\n5. **Fir-Riqab (For Freeing Captives/Slaves)**\n - Today, this includes freeing people from human trafficking, paying off debts that enslave people, or freeing prisoners of war\n\n6. **Al-Gharimin (The Indebted)**\n - Those who borrowed for a legitimate need and cannot repay\n - The debt must not be from sinful expenditure (gambling, luxury beyond means)\n\n7. **Fi Sabilillah (In the Cause of Allah)**\n - Scholarship and religious education that serves the community\n - Some scholars limit this to military defense; others expand to da'wah and education\n - Controversial area — consult a scholar for your context\n\n8. **Ibn as-Sabil (The Stranded Traveler)**\n - A traveler cut off from their resources in a foreign place\n - Even if they are wealthy at home, if they lack access to funds now, they qualify\n\n**Who CANNOT receive Zakat:**\n\n- The wealthy (those above nisab)\n- Your parents, grandparents, children, and grandchildren\n- Your spouse (husband cannot give Zakat to wife; wife can to husband in Hanafi opinion)\n- Non-Muslims (Zakat is for Muslims; give them sadaqah instead)\n\n**Modern distribution channels:**\n\n- Local mosques with Zakat committees\n- Registered Islamic charities with transparent distribution\n- Direct giving to verified individuals in the 8 categories\n- Zakat apps that verify recipients\n\n**The intention at payment:**\n\nSay silently: 'I pay this Zakat for the sake of Allah, fulfilling my obligation, seeking purification and reward.' If you forget to make the intention, it still counts because the act itself carries the intention by default.\n\n## 🤔 Reflection\n\nMany Muslims give Zakat to their favorite charity without checking if the recipients are in the 8 categories. That is like paying your electricity bill to the water company — the money leaves your account, but the obligation remains. Do you know where your Zakat went last year? Do you know the names of the people it fed? The Sunnah is to give with awareness and follow-up.\n\n## ⚡ Action Step\n\nResearch three Zakat-distributing organizations in your country. Check their transparency reports. Verify they distribute according to the 8 categories. Choose one and schedule your Zakat payment with them before the end of this month.\n\n---\n\n*Sources: Quran 9:60, Sahih al-Bukhari, Sahih Muslim, Tafsir Ibn Kathir, Fiqh us-Sunnah*"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"slug": "hajj-umrah-guide",
|
||||
"title": "Hajj & Umrah Guide",
|
||||
"author": "Dr. Khalid Al-Farsi",
|
||||
"description": "A comprehensive, step-by-step guide to the rituals of Hajj and Umrah. Covers ihram, miqat, tawaf, sa'i, standing at Arafat, the days of Mina, and common mistakes pilgrims make.",
|
||||
"imageUrl": "/images/courses/hajj-umrah-guide.jpg",
|
||||
"difficulty": "advanced",
|
||||
"giteaPath": "courses/hajj-umrah-guide",
|
||||
"priceFlh": 500,
|
||||
"priceUsd": null,
|
||||
"subscriptionOnly": true,
|
||||
"published": true,
|
||||
"modules": [
|
||||
{
|
||||
"order": 1,
|
||||
"title": "The Obligation & Types of Pilgrimage",
|
||||
"slug": "obligation-types-pilgrimage",
|
||||
"keyTakeaway": "Hajj is obligatory once in a lifetime for those who are able. Umrah is recommended and can be performed any time of year.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/hajj-umrah-guide/module-01.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "How many times is Hajj obligatory in a Muslim's lifetime?",
|
||||
"options": [
|
||||
"Every year if able",
|
||||
"Once, if the conditions of ability are met",
|
||||
"Twice, once in youth and once in old age",
|
||||
"Three times minimum"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The Prophet ﷺ said: 'Hajj is only once, and whoever does more, it is supererogatory.' (Sunan al-Nasa'i 2623). It is obligatory once for those with physical health, sufficient wealth for travel, and safe passage."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nHajj is the **fifth pillar of Islam** and the culmination of a Muslim's spiritual journey. It is obligatory **once in a lifetime** for every Muslim who meets five conditions. Umrah, the lesser pilgrimage, is a separate ritual that can be performed multiple times and at any time of year.\n\nAllah says: 'And Hajj to the House is a duty that mankind owes to Allah, for those who are able to undertake the journey.' (Quran 3:97)\n\n## 📖 Details\n\n**The five conditions that make Hajj obligatory:**\n\n1. **Islam** — only a Muslim's Hajj is accepted\n2. **Puberty and sanity** — must be accountable (mukallaf)\n3. **Physical ability** — able to walk, ride, or be carried without severe harm\n4. **Financial ability** — has sufficient wealth for travel, accommodation, and family support during absence\n5. **Safe passage** — the route must be secure; if there is war or grave danger, Hajj is deferred\n\n**The three types of Hajj:**\n\n| Type | Description | Best for |\n|---|---|---|\n| **Ifrad** | Hajj only, no Umrah | Residents of Makkah |\n| **Tamattu'** | Umrah first, then Hajj with a break in between | Those coming from outside Makkah |\n| **Qiran** | Combined Umrah and Hajj without a break | Those who can maintain ihram throughout |\n\nThe Prophet ﷺ performed Tamattu' and commanded his companions to do so. It is the recommended form for international pilgrims.\n\n**Umrah vs. Hajj:**\n\n| | Umrah | Hajj |\n|---|---|---|\n| Obligation | Recommended (sunnah mu'akkadah) | Obligatory (once) |\n| Timing | Any time of year | Specific dates: 8th-13th Dhul-Hijjah |\n| Duration | Few hours | 5-6 days minimum |\n| Rites | Ihram, Tawaf, Sa'i, Halq/Taqsir | Ihram, Arafat, Muzdalifah, Mina, Tawaf, Sa'i, Halq |\n| Ihram restrictions | Same as Hajj | Same as Umrah |\n\n**The spiritual significance:**\n\nHajj is not tourism. It is a journey of death and rebirth. The pilgrim leaves behind their clothes, their titles, their wealth, and their ego. They stand in simple white cloth before Allah as every human will stand on the Day of Judgment — stripped of everything except their deeds. The Prophet ﷺ said, 'Whoever performs Hajj and does not commit any obscenity or transgression, he returns as the day his mother bore him.' (Sahih al-Bukhari 1521)\n\n## 🤔 Reflection\n\nMany Muslims delay Hajj until old age, treating it like retirement. But the conditions require ability — and ability can be lost overnight through illness, debt, or global events. The Prophet ﷺ hastened to perform his only Hajj (Hajjat al-Wada') despite ruling a vast nation. If you meet the conditions now, what are you waiting for?\n\n## ⚡ Action Step\n\nIf you have not performed Hajj and meet the conditions, open your calendar and pick a target year. Open a dedicated savings account for Hajj and deposit a small amount monthly. The intention is the first step; preparation is the second.\n\n---\n\n*Sources: Quran 3:97, Sahih al-Bukhari, Sahih Muslim, Sunan al-Nasa'i, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 2,
|
||||
"title": "Ihram & The Miqat Boundaries",
|
||||
"slug": "ihram-and-miqat",
|
||||
"keyTakeaway": "Ihram begins at the miqat with intention and talbiyah. Once in ihram, normal activities like cutting hair, using perfume, and marital relations are forbidden until the rites are complete.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/hajj-umrah-guide/module-02.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "What happens if a pilgrim intentionally cuts a hair while in ihram?",
|
||||
"options": [
|
||||
"Nothing, it is a minor issue",
|
||||
"The Hajj is invalidated completely",
|
||||
"A penalty (dam) is required: sacrificing a sheep or fasting three days",
|
||||
"They must restart ihram from the miqat"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "Intentionally violating ihram restrictions requires a dam (penalty): either sacrificing a sheep within the Haram area, feeding six poor people, or fasting three days. The Hajj itself remains valid."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nIhram is the sacred state a pilgrim enters before crossing the miqat boundary. It is not merely the white clothes — it is a state of the soul. From the moment you make intention and say the talbiyah, you are in a contract of consecration with Allah.\n\nThe Prophet ﷺ said, 'The pilgrims performing Hajj and Umrah are the guests of Allah. If they ask, He gives. If they call upon Him, He answers. If they seek forgiveness, He forgives.' (Sunan Ibn Majah 2891)\n\n## 📖 Details\n\n**The five miqat stations:**\n\n| Miqat | Location | For pilgrims from |\n|---|---|---|\n| **Dhu al-Hulayfah** | South of Madinah | Madinah and points north |\n| **Juhfah** | Near Rabigh | Syria, Egypt, North Africa, Europe |\n| **Qarn al-Manazil** | Near Taif | Najd, Riyadh, Gulf countries, Asia |\n| **Yalamlam** | South of Makkah | Yemen, India, Pakistan, Southeast Asia |\n| **Dhat Irq** | Northeast of Makkah | Iraq, Iran, Central Asia |\n\nIf you are flying to Jeddah, you enter ihram before the plane crosses the miqat. Most airlines announce this. If you miss it, you must go back to the nearest miqat or sacrifice a dam (penalty sheep).\n\n**How to enter ihram:**\n\n1. **Purify yourself** — ghusl (full bath) is recommended, wudu is sufficient\n2. **Wear ihram clothing** — men: two unstitched white cloths (rida' and izar); women: any modest clothing that covers properly, avoiding perfume\n3. **Make intention** — in your heart, specify whether Hajj or Umrah\n4. **Say the talbiyah** — 'Labbayka Allahumma labbayk, labbayka la sharika laka labbayk, innal-hamda wan-ni'mata laka wal-mulk, la sharika lak'\n\n**What is forbidden in ihram:**\n\n- Cutting or shaving hair\n- Clipping nails\n- Using perfume or scented soap\n- Wearing stitched clothing (for men)\n- Covering the head (for men) or face (for women)\n- Hunting or killing animals\n- Marital relations and anything leading to arousal\n- Arguing, fighting, or using foul language\n\n**Penalties for violations:**\n\nIf you violate intentionally:\n- **Cutting hair/shaving/nails:** Sacrifice a sheep (dam) or fast 3 days or feed 6 poor people\n- **Wearing perfume:** Wash it off, no further penalty\n- **Covering head (men):** Remove immediately, no penalty if brief\n- **Marital relations before the first tahallul (release):** Hajj is invalidated; must complete the rites and repeat Hajj the following year with a new sacrifice\n\n**The talbiyah:**\n\nSay it frequently from the miqat until the stoning of Jamarat on the 10th of Dhul-Hijjah (for Hajj) or until shaving (for Umrah). Women say it softly; men say it aloud.\n\n## 🤔 Reflection\n\nIhram clothing looks simple, but it is the great equalizer. A billionaire and a beggar stand side by side in identical white cloth. The only distinction is taqwa. Have you ever felt that level of equality? That is the reality of the grave and the Day of Judgment. Hajj is a rehearsal.\n\n## ⚡ Action Step\n\nIf you are planning Hajj or Umrah, buy your ihram clothes now and practice wearing them at home for one hour. Get used to the feel. Learn to fold the lower cloth so it does not fall. Preparation removes anxiety.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan Abi Dawud, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 3,
|
||||
"title": "Tawaf & Sa'i — The Core Rites",
|
||||
"slug": "tawaf-and-sai",
|
||||
"keyTakeaway": "Tawaf is circumambulating the Ka'bah seven times. Sa'i is walking between Safa and Marwah seven times. Both are pillars of Umrah and Hajj.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/hajj-umrah-guide/module-03.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "How many circuits (ashwat) are required for a complete Tawaf?",
|
||||
"options": [
|
||||
"3",
|
||||
"5",
|
||||
"7",
|
||||
"10"
|
||||
],
|
||||
"correctIndex": 2,
|
||||
"explanation": "Tawaf consists of seven circuits around the Ka'bah, starting from the Black Stone (Hajar al-Aswad) and keeping the Ka'bah on your left. Each circuit is called a shawt."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nTawaf and Sa'i are the two core rites shared by both Hajj and Umrah. They are the physical expression of surrender: circling the House of Allah as the angels circle the Throne, and walking in the footsteps of Hajar as she searched for water for her son Ismail.\n\nThe Prophet ﷺ said, 'The Tawaf around the House is like the prayer, except that you speak during it. So whoever speaks, let him only speak good.' (Sunan al-Tirmidhi 960)\n\n## 📖 Details\n\n**Tawaf — Circumambulation:**\n\n**Conditions for valid Tawaf:**\n1. Intention — in the heart\n2. Purity from major impurity — ghusl recommended, wudu obligatory\n3. Covering the awrah properly\n4. Seven complete circuits\n5. Starting from the Black Stone\n6. Keeping the Ka'bah on your left\n7. Performing it inside Masjid al-Haram\n\n**How to perform Tawaf:**\n\n1. Approach the Black Stone corner. If possible, kiss it or touch it. If not, raise your hand toward it and say: 'Bismillah, Allahu Akbar'\n2. Begin walking counter-clockwise (Ka'bah on your left)\n3. Men should perform idtiba' (uncovering the right shoulder) and ramal (brisk walking with short steps) only during the first three circuits of Tawaf al-Qudum (arrival Tawaf)\n4. In each circuit, when you reach the Yemeni Corner (Rukn al-Yamani), touch it if possible and say 'Allahu Akbar'\n5. Do not raise your hand toward it from afar — only touch or pass silently\n6. Between the Yemeni Corner and the Black Stone, say: 'Rabbana atina fid-dunya hasanatan wa fil-akhirati hasanatan wa qina 'adhaban-nar'\n7. Complete seven circuits. The eighth pass by the Black Stone ends the Tawaf\n\n**Du'a during Tawaf:**\n\nThere is no fixed du'a. Recite Quran, make personal supplications, and praise Allah. The Prophet ﷺ said, 'Tawaf around the House is a prayer.' So maintain focus and avoid idle talk.\n\n**Sa'i — Walking between Safa and Marwah:**\n\nAfter Tawaf, perform two rak'ahs behind Maqam Ibrahim if possible, then drink Zamzam, and proceed to Safa.\n\n1. Stand on Safa facing the Ka'bah. Say: 'La ilaha ill-Allah, Allahu Akbar' three times\n2. Make du'a — the Prophet ﷺ would praise Allah and ask for what he wished\n3. Walk toward Marwah. Men run between the two green lights (the area where Hajar ran)\n4. On reaching Marwah, repeat the same praise and du'a\n5. This is one complete round\n6. Repeat until you complete seven rounds (starting at Safa and ending at Marwah)\n\n**Important notes:**\n\n- Sa'i can be performed sitting if there is weakness, illness, or disability\n- Pushing a wheelchair for someone counts as valid Sa'i for the pusher\n- There is no specific du'a required between Safa and Marwah — personal supplication is preferred\n\n## 🤔 Reflection\n\nTawaf is the only ritual in Islam where you move while praying. It breaks the static posture of salah and teaches that worship is dynamic — you can be in a state of prayer while walking, traveling, or working. What if you carried that awareness beyond the Haram? What if your entire life became a Tawaf around the values of your faith?\n\n## ⚡ Action Step\n\nWatch a video of Tawaf and Sa'i before sleeping tonight. Familiarize yourself with the layout of Masjid al-Haram. Memorize the talbiyah and the du'a between the Yemeni Corner and the Black Stone. Visual familiarity reduces real-world anxiety by 60%.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Tirmidhi, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 4,
|
||||
"title": "Standing at Arafat & The Days of Mina",
|
||||
"slug": "arafat-and-mina",
|
||||
"keyTakeaway": "Standing at Arafat on the 9th of Dhul-Hijjah is the essence of Hajj. Missing it invalidates the Hajj. The days of Mina follow, with stoning, sacrifice, and shaving.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/hajj-umrah-guide/module-04.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "Which day of Hajj is known as Yaum al-Arafah (the Day of Arafat)?",
|
||||
"options": [
|
||||
"The 8th of Dhul-Hijjah (Yawm at-Tarwiyah)",
|
||||
"The 9th of Dhul-Hijjah",
|
||||
"The 10th of Dhul-Hijjah (Eid al-Adha)",
|
||||
"The 12th of Dhul-Hijjah"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The 9th of Dhul-Hijjah is the Day of Arafat. The Prophet ﷺ said: 'Hajj is Arafat.' (Sunan al-Nasa'i 3016). Standing at Arafat from noon until sunset on this day is the central pillar of Hajj."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nThe Prophet ﷺ said, 'Hajj is Arafat.' (Sunan al-Nasa'i 3016). This means that standing at Arafat on the 9th of Dhul-Hijjah is the heart of Hajj. Without it, there is no Hajj. Everything before is preparation; everything after is completion.\n\nArafat is also the place where Adam and Hawwa' were reunited after being expelled from Paradise. It is the plain where humanity will be resurrected. Standing there in humility is a rehearsal for the Day of Judgment.\n\n## 📖 Details\n\n**The Hajj timeline:**\n\n| Day | Date | Key Ritual |\n|---|---|---|\n| Day 1 | 8th Dhul-Hijjah | Enter ihram, go to Mina, pray Dhuhr, Asr, Maghrib, Isha, Fajr |\n| Day 2 | 9th Dhul-Hijjah | Stand at Arafat from noon to sunset; then Muzdalifah |\n| Day 3 | 10th Dhul-Hijjah | Stoning Jamarat al-Aqabah; sacrifice (qurbani); shave; Tawaf al-Ifadah; Sa'i |\n| Days 4-5 | 11th-12th Dhul-Hijjah | Stoning the three Jamarat each day; depart Mina before Maghrib on 12th |\n| Optional | 13th Dhul-Hijjah | Additional stoning day for those who stayed\n\n**Standing at Arafat (Wuquf):**\n\n- **Timing:** From the time the sun passes its zenith (Dhuhr) until sunset (Maghrib)\n- **Location:** Anywhere within the boundaries of Arafat — the plain is vast\n- **What to do:** Combine Dhuhr and Asr prayers (two rak'ahs each), make du'a, read Quran, remember Allah, and weep in repentance\n- **What NOT to do:** Fast on this day if you are at Arafat (the Prophet ﷺ broke his fast)\n\n**The best du'a on Arafat:**\n\nThe Prophet ﷺ said, 'The best du'a is the du'a on the Day of Arafat. And the best thing I and the prophets before me said is: La ilaha ill-Allah, wahdahu la sharika lahu, lahu al-mulk, wa lahu al-hamd, wa huwa 'ala kulli shay'in qadir.' (Sunan al-Tirmidhi 3585)\n\n**Muzdalifah:**\n\nAfter sunset on Arafat, pilgrims proceed to Muzdalifah. They pray Maghrib and Isha combined (three rak'ahs + two rak'ahs), collect pebbles for the stoning, and spend the night under the open sky.\n\n**The stoning of Jamarat:**\n\n- **Jamarat al-Aqabah (the Big One):** Stoned on the 10th with **seven pebbles** while saying 'Allahu Akbar' each time\n- **The three Jamarat:** Stoned on the 11th and 12th (and 13th if staying) with seven pebbles each, starting with the smallest (al-Ula), then middle (al-Wusta), then largest (al-Aqabah)\n\n**The sacrifice (Qurbani/Udhiyah):**\n\nAfter stoning the big Jamarat on the 10th, pilgrims sacrifice an animal — sheep, goat, cow, or camel. This commemorates Ibrahim's willingness to sacrifice Ismail. The meat is distributed: one-third for the pilgrim, one-third for family, one-third for the poor.\n\n**Shaving or cutting hair (Halq/Taqsir):**\n\nMen shave their heads completely (recommended) or cut a lock. Women cut a fingertip's length from their hair. This is the first release (tahallul al-asghar) from ihram restrictions.\n\n## 🤔 Reflection\n\nArafat is the only day in the Islamic calendar when the sun does not set before the du'a of the pilgrims is accepted. Allah descends to the lowest heaven and says: 'Are there any who ask, that I may give? Are there any who seek forgiveness, that I may forgive?' (Sahih Muslim 758) What will you ask for? Health? Wealth? Or the thing that matters most: Allah's pleasure and Paradise?\n\n## ⚡ Action Step\n\nWrite a 'Arafat Du'a List' — 10 specific things you want to ask Allah for when you stand on the plain of Arafat. Include one du'a for the Ummah, one for your family, one for your own forgiveness, and one for the Hereafter. Keep this list in your travel documents.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Nasa'i, Sunan al-Tirmidhi, Fiqh us-Sunnah*"
|
||||
},
|
||||
{
|
||||
"order": 5,
|
||||
"title": "Umrah Step-by-Step & Common Mistakes",
|
||||
"slug": "umrah-step-by-step",
|
||||
"keyTakeaway": "Umrah can be completed in a few hours: ihram at miqat, Tawaf, Sa'i, and shaving/cutting hair. Plan logistics and avoid common errors.",
|
||||
"duration": 3,
|
||||
"audioPath": "/audio/learn/hajj-umrah-guide/module-05.mp3",
|
||||
"quizData": {
|
||||
"questions": [
|
||||
{
|
||||
"question": "What is the final act that releases a pilgrim from the state of ihram after Umrah?",
|
||||
"options": [
|
||||
"Completing Sa'i",
|
||||
"Shaving the head (halq) or cutting a lock (taqsir)",
|
||||
"Praying two rak'ahs behind Maqam Ibrahim",
|
||||
"Drinking Zamzam water"
|
||||
],
|
||||
"correctIndex": 1,
|
||||
"explanation": "The release from ihram after Umrah occurs through shaving the head (halq for men, recommended) or cutting a small amount of hair (taqsir for women). This is called tahallul and ends all ihram restrictions."
|
||||
}
|
||||
]
|
||||
},
|
||||
"content": "## 🎯 Key Concept\n\nUmrah is the 'minor pilgrimage' — shorter, simpler, and performable any time of year. It consists of only four acts: enter ihram at the miqat, perform Tawaf, perform Sa'i, and cut or shave the hair. The entire ritual can be completed in 2–4 hours.\n\nThe Prophet ﷺ said, 'Perform Umrah repeatedly, for it removes sins as the bellows remove impurities from iron.' (Sahih al-Bukhari 1773)\n\n## 📖 Details\n\n**Umrah step-by-step:**\n\n**Step 1: Ihram at the Miqat**\n- Purify yourself (ghusl recommended)\n- Wear ihram clothing\n- Make intention: 'Labbayk Allahumma bi-Umrah'\n- Say the talbiyah\n\n**Step 2: Arrive in Makkah and perform Tawaf**\n- Enter Masjid al-Haram with your right foot\n- Approach the Black Stone\n- Perform seven circuits of Tawaf\n- Pray two rak'ahs behind Maqam Ibrahim if possible\n- Drink Zamzam water\n\n**Step 3: Perform Sa'i**\n- Go to Safa (it is now inside the mosque extension, not outside)\n- Ascend Safa, face Qiblah, praise Allah, make du'a\n- Walk to Marwah — men run between the two green lights\n- Seven rounds total, ending at Marwah\n\n**Step 4: Halq or Taqsir (shaving or cutting hair)**\n- Men: shave the entire head or cut all hair short\n- Women: cut a fingertip-length (approximately 1–2 cm) from the end of their hair\n- This releases you from ihram completely\n\n**Common mistakes pilgrims make:**\n\n1. **Forgetting the intention** — Some enter Makkah without making intention for Umrah. Their Tawaf counts as a voluntary Tawaf, not Umrah. Always make the intention before or at the miqat.\n\n2. **Performing Tawaf without wudu** — If you break wudu during Tawaf, you must leave, renew wudu, and resume from where you stopped. The interrupted circuit still counts.\n\n3. **Counting the Black Stone as a circuit** — The circuit begins when you pass the Black Stone and ends when you return to it. Seven passes = seven circuits.\n\n4. **Men covering their heads in ihram** — Even briefly putting on a cap or using an umbrella touching the head requires a penalty. Be vigilant.\n\n5. **Using scented products** — Scented soap, shampoo, deodorant, and even scented tissues are forbidden in ihram. Buy unscented products before traveling.\n\n6. **Rushing Sa'i** — Sa'i is not a race. Walk with dignity and make du'a. The area between Safa and Marwah is approximately 450 meters. Seven rounds = about 3.15 km. Pace yourself.\n\n7. **Cutting hair before Sa'i** — The sequence matters: Tawaf → two rak'ahs → Sa'i → THEN cut hair. Cutting before Sa'i invalidates nothing but breaks the preferred order.\n\n**Practical tips for Umrah:**\n\n- Wear comfortable walking shoes with good grip (the marble floors are slippery)\n- Carry a small waist bag for your phone, money, and ID\n- Keep a copy of your passport and visa on your phone\n- Stay hydrated — the mosque has Zamzam stations everywhere\n- Be patient with crowds; push no one and harm no one\n\n## 🤔 Reflection\n\nUmrah is a gift. Unlike Hajj, which has fixed dates and high costs, Umrah is accessible to almost every Muslim at almost any time. Yet many never go. The Prophet ﷺ performed Umrah four times in his life. What if you made a habit of Umrah once every few years? What would it do to your heart to keep returning to the House of Allah?\n\n## ⚡ Action Step\n\nIf you have never performed Umrah, open your calendar and pick a 3-day window in the next 12 months. Research visa requirements for Saudi Arabia in your country. Create a savings fund labeled 'Umrah.' The intention is the seed; the plan is the water.\n\n---\n\n*Sources: Sahih al-Bukhari, Sahih Muslim, Sunan al-Tirmidhi, Fiqh us-Sunnah, Hajj & Umrah guide by Ministry of Hajj, Saudi Arabia*"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,132 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Local TTS generation for FalahMobile Learn content.
|
||||
* Uses macOS `say` + `afconvert` (fallback: ffmpeg/lame if available).
|
||||
* Reads prisma/seed-learn.json and generates MP3s for modules with audioPath.
|
||||
*/
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const { execSync } = require('child_process');
|
||||
|
||||
const PROJECT_ROOT = path.resolve(__dirname, '..');
|
||||
const SEED_PATH = path.join(PROJECT_ROOT, 'prisma', 'seed-learn.json');
|
||||
const PUBLIC_DIR = path.join(PROJECT_ROOT, 'public');
|
||||
|
||||
// Check available TTS tools
|
||||
function detectTtsEngine() {
|
||||
try {
|
||||
execSync('which say', { stdio: 'ignore' });
|
||||
return { type: 'say', aiff: true };
|
||||
} catch {}
|
||||
try {
|
||||
execSync('which espeak', { stdio: 'ignore' });
|
||||
return { type: 'espeak', wav: true };
|
||||
} catch {}
|
||||
try {
|
||||
execSync('which piper', { stdio: 'ignore' });
|
||||
return { type: 'piper', wav: true };
|
||||
} catch {}
|
||||
return null;
|
||||
}
|
||||
|
||||
function stripMarkdown(text) {
|
||||
return text
|
||||
.replace(/^---\n[\s\S]*?---\n/, '')
|
||||
.replace(/[\u{1F300}-\u{1F9FF}]/gu, ' ')
|
||||
.replace(/^#+\s+/gm, '')
|
||||
.replace(/\*\*?|\*\*?/g, '')
|
||||
.replace(/^>\s*/gm, '')
|
||||
.replace(/```[\s\S]*?```/g, '')
|
||||
.replace(/`[^`]+`/g, '')
|
||||
.replace(/^---+$/gm, '')
|
||||
.replace(/<[^>]+>/g, '')
|
||||
.replace(/\n{3,}/g, '\n\n')
|
||||
.trim();
|
||||
}
|
||||
|
||||
function generateSayM4a(text, outputPath) {
|
||||
const tmpTxt = outputPath.replace(path.extname(outputPath), '.txt');
|
||||
fs.writeFileSync(tmpTxt, text, 'utf-8');
|
||||
try {
|
||||
// macOS say outputs AAC in .m4a directly with --file-format m4af
|
||||
execSync(`say -v "Samantha" --file-format m4af -f "${tmpTxt}" -o "${outputPath}"`, { stdio: 'ignore' });
|
||||
fs.unlinkSync(tmpTxt);
|
||||
return true;
|
||||
} catch (e) {
|
||||
console.error(' say failed:', e.message);
|
||||
try { fs.unlinkSync(tmpTxt); } catch {}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function generateEspeakWav(text, outputPath) {
|
||||
const tmpWav = outputPath.replace('.mp3', '.wav');
|
||||
try {
|
||||
execSync(`espeak -v en-us -s 150 -w "${tmpWav}" "${text.replace(/"/g, '\\"')}"`, { stdio: 'ignore' });
|
||||
// Convert WAV to MP3 via lame or ffmpeg
|
||||
try {
|
||||
execSync(`lame -V 7 "${tmpWav}" "${outputPath}"`, { stdio: 'ignore' });
|
||||
} catch {
|
||||
execSync(`ffmpeg -y -i "${tmpWav}" -codec:a libmp3lame -qscale:a 5 "${outputPath}"`, { stdio: 'ignore' });
|
||||
}
|
||||
fs.unlinkSync(tmpWav);
|
||||
return true;
|
||||
} catch (e) {
|
||||
console.error(' espeak failed:', e.message);
|
||||
try { fs.unlinkSync(tmpWav); } catch {}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
function main() {
|
||||
const engine = detectTtsEngine();
|
||||
if (!engine) {
|
||||
console.error('No local TTS engine found. Install one of: say (macOS), espeak, piper');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log(`Using TTS engine: ${engine.type}`);
|
||||
|
||||
const seed = JSON.parse(fs.readFileSync(SEED_PATH, 'utf-8'));
|
||||
let generated = 0;
|
||||
let failed = 0;
|
||||
|
||||
for (const course of seed.courses) {
|
||||
for (const mod of course.modules || []) {
|
||||
if (!mod.audioPath) continue;
|
||||
const outPath = path.join(PUBLIC_DIR, mod.audioPath);
|
||||
// Skip if already exists and > 1KB
|
||||
if (fs.existsSync(outPath) && fs.statSync(outPath).size > 1024) {
|
||||
console.log(` SKIP (exists): ${mod.audioPath}`);
|
||||
continue;
|
||||
}
|
||||
|
||||
// Ensure directory exists
|
||||
fs.mkdirSync(path.dirname(outPath), { recursive: true });
|
||||
|
||||
const text = stripMarkdown(mod.content || mod.keyTakeaway || '');
|
||||
if (!text || text.length < 50) {
|
||||
console.log(` SKIP (no content): ${mod.title}`);
|
||||
continue;
|
||||
}
|
||||
|
||||
// Truncate to ~4000 chars to keep file sizes reasonable
|
||||
const ttsText = text.slice(0, 4000);
|
||||
console.log(`Generating: ${mod.audioPath} (${ttsText.length} chars)`);
|
||||
|
||||
const ok = engine.type === 'say'
|
||||
? generateSayM4a(ttsText, outPath)
|
||||
: generateEspeakWav(ttsText, outPath);
|
||||
|
||||
if (ok) {
|
||||
generated++;
|
||||
} else {
|
||||
failed++;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log(`\nDone: ${generated} generated, ${failed} failed`);
|
||||
}
|
||||
|
||||
main();
|
||||
+7
-2
@@ -4,11 +4,16 @@ import { AuthProvider } from "@/lib/AuthContext";
|
||||
import BottomNav from "@/components/BottomNav";
|
||||
import PWARegister from "@/components/PWARegister";
|
||||
|
||||
export const viewport = {
|
||||
width: "device-width",
|
||||
initialScale: 1,
|
||||
viewportFit: "cover",
|
||||
themeColor: "#0a0a0f",
|
||||
};
|
||||
|
||||
export const metadata: Metadata = {
|
||||
title: "Falah — Islamic Lifestyle",
|
||||
description: "Nur AI coaching, Halal marketplace, community & wallet",
|
||||
viewport: "width=device-width, initial-scale=1, viewport-fit=cover",
|
||||
themeColor: "#0a0a0f",
|
||||
appleWebApp: { capable: true, statusBarStyle: "black-translucent" },
|
||||
manifest: "/mobile/manifest.json",
|
||||
icons: {
|
||||
|
||||
Reference in New Issue
Block a user