Skip to content

kq1231/escape

Repository files navigation

Escape - Your Path to Spiritual Freedom 🌙

In the name of Allah, the Most Merciful, the Most Compassionate

"And those who strive for Us - We will surely guide them to Our ways. And indeed, Allah is with the doers of good."
Surah Al-Ankabut 29:69

A Revolutionary Journey Towards Purity

Escape is more than just an app - it's a blessed companion on your journey to break free from the chains of sins and all forms of spiritual darkness. Designed with Islamic principles at its core, this app serves Muslims worldwide and anyone seeking to reclaim their spiritual purity and mental clarity.

🕋 Islamic Foundation

Every feature in Escape is built upon the foundation of Tawbah (repentance) and Tazkiyah (spiritual purification). We believe that true change comes through Allah's mercy combined with sincere effort and proper guidance.

✨ Key Features

📊 Streak Tracking with Barakah

  • Track your clean days with Islamic calendar integration
  • Daily reminders with Quranic verses and authentic duas
  • Visual progress with spiritual milestones

🎯 Challenges & Rewards

  • Ramadan-focused challenges
  • Daily dhikr challenges
  • Sadaqah-based reward system
  • Community challenges with fellow Muslims

🤖 AI Islamic Counselor

  • 24/7 AI chat support grounded in Islamic teachings
  • Fatwa-based guidance on dealing with urges
  • Personalized spiritual advice from authentic sources

🕌 Salah Tracker Integration

  • Prayer time reminders as distraction techniques
  • Qibla direction for spiritual grounding
  • Quran recitation suggestions during difficult moments

🎯 Personal Triggers & Strategies

  • Identify personal triggers with Islamic mindfulness
  • Access to prophetic strategies for self-control
  • Customized coping mechanisms from Quran and Sunnah

📱 Relapse Recording & Recovery

  • Non-judgmental relapse tracking
  • Immediate spiritual first-aid with relevant verses
  • Rapid recovery protocols based on Islamic teachings

📚 Islamic Content Library

  • Curated videos from authentic scholars
  • Articles on spiritual purification
  • Success stories from the ummah
  • Daily Islamic reminders and motivation

🌟 Built with Barakah

Tech Stack

  • Flutter: Cross-platform development for maximum reach
  • Riverpod: Clean state management for smooth user experience
  • ObjectBox: Fast local storage for offline capability
  • Supabase: Secure cloud backend for community features
  • Flutter Mix: Modern design system for beautiful UI

Design Philosophy

  • Atomic Design: Scalable and maintainable component architecture
  • Adaptive UI: Seamless experience across all devices
  • Islamic Design: Beautiful, modest, and spiritually uplifting interface

🚀 Getting Started

Prerequisites

Flutter SDK: ^3.8.1
Dart SDK: ^3.8.1

Installation

# Clone the repository
git clone https://github.com/your-username/escape.git

# Navigate to project
cd escape

# Install dependencies
flutter pub get

# Run the app
flutter run

🤝 Contributing

This is a sadaqah jariyah (continuous charity) project. Every contribution helps save lives and souls. We welcome:

  • Code contributions from Muslim developers
  • Islamic content from scholars and students of knowledge
  • Translations to reach more of the ummah
  • Duas for the success of this project

📖 Islamic Guidance

For Those Struggling

Remember that Allah says: "Say, 'O My servants who have transgressed against themselves [by sinning], do not despair of the mercy of Allah. Indeed, Allah forgives all sins. Indeed, it is He who is the Forgiving, the Merciful.'" (Surah Az-Zumar 39:53)

Daily Reminder

Make the dua of Prophet Yunus (AS):
"La ilaha illa anta, subhanaka, inni kuntu minaz-zalimin"
"There is no deity except You; exalted are You. Indeed, I have been of the wrongdoers."

📞 Support & Community

🙏 Make Dua

Please remember the entire team in your prayers. May Allah accept this effort, forgive our shortcomings, and make this a means of guidance for the entire ummah. Ameen.


"And remind, for indeed, the reminder benefits the believers."
Surah Adh-Dhariyat 51:55

Made with ❤️ and 🕌 for the sake of Allah

About

A companion on your journey to break free from the chains of sins!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •