Skip to content

rushdv/muhasabah

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

98 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŒ™ Muhasabah: Your Sacred Spiritual Hub

Status Module Analytics
Vercel Fly.io


Muhasabah (Self-Accountability) is a premium Islamic personal hub designed to bridge the gap between digital productivity and spiritual excellence. Inspired by the concept of Ihsan, this platform helps you track, reflect upon, and grow your relationship with Allah.


πŸ•Œ Featured Module: Ramadan Planner 1447 AH

Transform your Ramadan experience with our comprehensive, interactive spiritual companion. Designed for deep devotion and consistent growth.

✨ Spiritual Enlightenment (Daily Content)

  • Verse of the Day: Handpicked Quranic verses with Arabic text and meanings.
  • Al-Asmaul Husna: Daily dive into the Divine Attributes to cultivate love for Allah.
  • Prophetic Traditions: Authenticated Hadiths to guide your character (Adab).
  • Sacred Invocations: Selected Duas to keep your heart in constant remembrance.

πŸ•‹ Core Trackers

  • Interactive Salat Log: Track Fardh, Sunnah, and Voluntary prayers (Tahajjud, Taraweeh, Duha).
  • Quran Journey: Granular tracking by Para, Page, and Ayat with integrated reflection space.
  • Fasting Status: Simple, intuitive toggle for your daily sacred fast.
  • Checklist of Excellence: Morning/Evening Adhkar, Daily Sadaqah, Jamaat Salat, Istighfar, and more.

πŸ’– Soul Metrics

  • Spiritual Energy Monitoring: A unique 7-level tracking system to understand your spiritual highs and lows.
  • Soul’s Reflection: A private journal for heart-centered notes and personal victories.
  • 30-Day Sacred Timeline: A visual journey of your progress through the blessed month.

πŸ“Š Module: Spiritual Insights (Wrapped)

Reflect on your growth with beautiful, personalized analytics. See how your devotion has evolved over time.

  • Sacred Stats: Total fasted days and prayer consistency percentage.
  • Growth Milestones: Summaries of Divine Names learned and acts of Sadaqah.
  • Quranic Highlights: A condensed view of your progress with the Book of Allah.
  • Spiritual Trajectory: Personalized feedback on your journey of excellence.

πŸ› οΈ The Architecture

Frontend (Modern & High-Performance)

  • React + Vite: For a lightning-fast, reactive user experience.
  • Vanilla CSS + Tailwind: A custom-crafted design system focused on Islamic aesthetics.
  • Lucide-React: Elegant iconography for a spiritual feel.

Backend (Robust & Scalable)

  • FastAPI: High-performance Python framework for our API layer.
  • PostgreSQL + NeonDB: Cloud-native database for secure data persistence.
  • Alembic: Database versioning and migrations.
  • JWT Auth: Secure, stateless authentication with Google OAuth integration.

πŸš€ The Path Ahead (Roadmap)

Muhasabah is growing into a complete Islamic lifestyle suite:

  • Halal Finance: Zakat calculators and ethical portfolio tracking.
  • Sunnah Protocols: Habits and routines based on the life of the Prophet (ο·Ί).
  • Character Builder: Advanced tracking for Akhlaq and specific spiritual goals.

πŸ’» Technical Setup

Backend

cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

πŸ”’ Security & Privacy

Built with privacy-first principles. Your reflections and spiritual data are yours. We use standard JWT encryption and secure industry-standard OAuth 2.0.


πŸ“œ License

This project is dedicated to the Ummah under the MIT License.

About

πŸŒ™ Muhasabah is a faith-centered self-reflection and habit tracking platform inspired by the concept of daily accountability in Islam.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors