Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🕊 FindYourPeace

Connect your emotions with Quranic wisdom instantly.

"Indeed, in the remembrance of Allah do hearts find peace." — Quran 13:28


🌟 Overview

FindYourPeace is a spiritual companion that gives you authentic Quranic verses based on how you’re feeling.
Features:

  • 16 emotions, with verified verses of Qur'an
  • Light/Dark themes
  • Smart system (no repeated verses)
  • 100% private, no tracking

👨‍💻 About Me

Hi! I’m Syed Sajjad Hussain, final-year CSE student building tech to help people find comfort and peace.


🚀 How It Works

  1. Select your current emotion
  2. Get a relevant Quranic verse instantly
  3. Optionally get another verse or change emotion

Emotional States: Alone, Anxious, Blessed, Confused, Depressed, Fearful, Frustrated, Grateful, Happy, Hopeless, Impatient, In Love, Jealous, Proud, Sad, Unloved


🛠 Tech Stack

  • Backend: Python 3.13+, FastAPI, Uvicorn
  • Frontend: React 18.2, Vite, CSS3
  • Other: Axios, LocalStorage

💾 Quick Start

# Clone repository
git clone https://github.com/yourusername/FindYourPeace.git
cd FindYourPeace

# Backend
cd backend
pip install -r requirements.txt
python main.py  # http://localhost:8000

# Frontend
cd ../frontend
npm install
npm run dev     # http://localhost:3000

# Windows users
.\start.ps1

Releases

Packages

Contributors

Languages