Ashiyana e Jannat (آشیانہ جنت)

A premium, modern Islamic Habit Tracker and Spiritual Journal built with Flutter.

---

🌟 About the Project

Ashiyana e Jannat (meaning Home of Heaven) is a beautifully designed, lightweight, and offline-first mobile application designed to help Muslims track and build consistent daily spiritual habits.

The app features a curated warm, creamy aesthetic inspired by Islamic geometric patterns, combining deep forest greens, soft creamy beiges, and gold accents.

---

✨ Features

• 🕌 Daily Spiritual Tracker:
  • Track 5 Daily Prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) with individual status.
  • Recited Quran or Surah completions indicator.
  • Counter for Darood Shareef recitation.
  • Parents service (Khidmat) and Dua tracker.
  • Daily Good Deeds helper tracker.
• 📅 Interactive Journal:
  • View your tracking history organized inside a clean calendar.
  • Instantly load and inspect completed deeds for any selected day.
• 📊 Real-time Analytics & Trends:
  • Visualize progress trends over the last 7 days.
  • Interactive charts displaying daily counts of prayers, Quran, and good deeds.
• 📜 Daily Quranic & Hadith Quotes:
  • A beautiful custom splash screen displaying random, inspiring Quranic verses and Hadiths for returning users.
• 🔄 Instant Real-time Data Syncing:
  • All metrics automatically synchronize across all active screens (Home, History, Analytics, and Journal) in the background without layout blocking or progress flashes.
• 📱 Premium Native Launch:
  • Uses Flutter native splash integration for a 100% seamless, white-flash-free boot flow on Android 12+.

---

🛠️ Tech Stack & Architecture

• Core Framework: Flutter (iOS & Android support)
• Programming Language: Dart
• Local Storage: shared_preferences (fast, lightweight offline storage key-value pairs)
• Reactive State Management: Static lightweight ValueNotifier system for instant real-time synchronization between active screens.
• Assets & Graphics: Cleaned vector SVGs for rich, high-fidelity geometric backgrounds and UI components.

---

🚀 Getting Started

Prerequisites

Make sure you have the Flutter SDK installed on your system.

flutter --version

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/ashiyana_e_jannat.git
   cd ashiyana_e_jannat

2. Get dependencies:

   flutter pub get

3. Run the application:

   # Run in Debug mode
   flutter run
   
   # Run in Release mode (recommended for production performance test)
   flutter run --release

4. Build release APK (Android):

   flutter build apk --release

---

🔒 What to Hide (Git Best Practices)

To keep your repository clean and protect any local credentials, the .gitignore automatically hides the following files (do not remove them from gitignore):

• local.properties (contains your Android SDK paths)
• .idea/ and .vscode/ (workspace-specific editor configurations)
• .dart_tool/ and .pub-cache/ (local Dart compilation caches)
• build/ (compiled build outputs)

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.