🏃‍♀️ aidKRIYA Walker App

Serving Motion for the Nation
A Flutter-powered platform connecting walkers and wanderers for wellness and social good.

---

👥 Team Details

Team Name: localhost:6900
Members:

• Omkar Sanap
• Samarth Agarwal
• Yashendra

---

📘 Table of Contents

1. About the Project
2. App Concept
3. Key Features
4. Technology Stack
5. Installation & Setup
6. Firebase Configuration
7. Core Modules
8. App Flow
9. Presentation
10. Screenshots
11. How to Contribute
12. License & Credits
13. Contact & Support

---

🩵 About the Project

The aidKRIYA Walker App is a social wellness mobile application developed for the Aidothon 4.0 - Walker App Challenge 2025 organized by the Gita & Susil Kumar Das (GnSkD) Foundation.

It aims to connect Walkers (companions) and Wanderers (users) — promoting physical activity, combating loneliness, and enabling users to contribute to social causes with every walk.

Motto: "Serving Motion for the Nation"

---

💡 App Concept

A Walking Companion Platform for a Cause — where every walk becomes an act of kindness.

• Wanderers can request nearby verified walkers for companionship.
• Walkers can accept requests, coordinate, and accompany them.
• Both enjoy a safe, meaningful, and trackable experience.

---

✨ Key Features

✅ User Roles:

• Walker: Verified companions who accept walk requests.
• Wanderer: Individuals seeking safe, friendly walking partners.

✅ Core Functionalities:

• Google Sign-In Authentication
• Real-Time Request & Acceptance
• Firestore-based live updates for walk status
• GPS Location Tracking (Live Map)
• Payment Integration (Razorpay / UPI)
• SOS / Emergency Alerts
• Ratings & Reviews
• Chat Module
• Walk History & Analytics Dashboard
• Group Walks: Walkers can schedule and host community walking events for multiple Wanderers.
• Dynamic Fare Calculation: Transparent, itemized fare summaries are provided post-walk.

✅ Security & Trust:

• Intelligent Walker Matching: Profiles display a Best Match indicator for highly compatible pairings.
• Fraud Prevention: Automatic restriction for users with unresolved payment issues.
• Role-based access control
• Verified profiles & ID validation
• Background checks for Walkers

---

🧰 Technology Stack

Layer	Technology
Frontend	Flutter (Dart)
Backend	Firebase Firestore, Firebase Authentication
Payments	Razorpay / UPI
Maps	Google Maps API
Notifications	Firebase Cloud Messaging
State Management	Provider / Riverpod
Version Control	GitHub (Private Repository)

---

⚙️ Installation & Setup

1️⃣ Prerequisites

• Flutter SDK (>=3.16)
• Android Studio or VS Code
• Firebase project setup
• Google Maps API key

2️⃣ Clone the Repository

git clone https://github.com/Aidothon2025/team-localhost-6900.git
cd aidkriya_walker_app

3️⃣ Install Dependencies

flutter pub get

4️⃣ Run the App

flutter run

---

🔥 Firebase Configuration

1. Create a Firebase project → https://console.firebase.google.com
2. Add Android app package (e.g., com.aidkriya.walker)
3. Download and place google-services.json inside /android/app/
4. Enable:
   • Firebase Authentication (Google Sign-In)
   • Firestore Database
   • Cloud Storage
   • Cloud Messaging (optional)
5. Update Firestore Security Rules for role-based access.

---

📱 Core Modules

Module	Description
Authentication	Google Sign-In & Role verification
Request Walk	Wanderer requests nearby Walkers
Match & Accept	Walker views & accepts requests
Live Tracking	Real-time location sharing
Walk Summary	Distance, duration, and pace logged
Payments	Secure in-app transactions
Ratings	Both users rate each other post-walk

---

🔄 App Flow

1. Login / Register via Google

   • Both Walkers and Wanderers authenticate using Google Sign-In.
   • User roles are determined from Firestore (Walker or Wanderer).

2. Select Role → Walker / Wanderer

   • The user is directed to their respective dashboards.
   • The app updates the user’s online/offline status in Firestore in real time.

3. Set Up Profile

   • Each user completes their profile with photo, age, gender, interests, preferred walking time, and location preferences.
   • Walkers undergo verification before being visible for matching.

4. Request Phase (Wanderer → Walker)

   • A Wanderer can send a walk request to a nearby available Walker.
   • If both are online, the request instantly appears on the Walker’s dashboard.
   • If the Walker is offline, a push notification is sent via Firebase Cloud Messaging (FCM).
   • Tapping the notification opens the app directly on the Incoming Request Screen, allowing the Walker to accept or decline the request.

5. Acceptance & Cancellation Logic

   • Once the Walker accepts, both users enter the “Ready to Walk” state.
   • The Walker alone can start the walk (to ensure accountability).
   • If the Walker cancels before or during the walk → The total amount payable becomes ₹0 (no charge to Wanderer).
   • If the Wanderer cancels, a partial deduction applies based on elapsed time (e.g., cancellation fee proportional to minutes booked).
   • Both users receive in-app alerts and push notifications about acceptance, start, or cancellation events.

6. Real-Time Tracking

   • Once started by the Walker, both users can track live GPS locations on an embedded Google Map.
   • The backend continuously logs duration, distance, and status (active/completed) in Firestore.

7. Walk Completion & Payment

   • The Walker ends the session once the walk is completed.
   • Payment is automatically calculated and processed via Razorpay/UPI.
   • Both parties are prompted to rate and review each other.

8. Post-Walk Summary

   • A detailed summary (date, distance, duration, total cost, and partner rating) is stored in Walk History.
   • Users can view past walks and earnings (for Walkers) in their dashboards.

---

🎬 Presentation

The full feature overview and demonstration of the application:

Feature Overview PPT: https://drive.google.com/file/d/1ulNPnsohvbAqMu77AO-VjfObuZ0vhLg_/view?usp=sharing

---

🖼 Screenshots

Below are key screens from the aidKRIYA Walker App, organized in compact pairs for better readability.

---

## 🤝 How to Contribute
1. Fork this repository under [Aidothon2025 GitHub Org](https://github.com/orgs/Aidothon2025/repositories)  
2. Commit all changes to your private repo:
```bash
git add .
git commit -m "Initial submission"
git push origin main

3. Include this README.md and your Firebase setup instructions before the final submission.

---

📜 License & Credits

© 2025 Gita & Susil Kumar Das (GnSkD) Foundation
aidKRIYA Walker App is developed under Aidothon 4.0 - Walker App Challenge 2025.

All rights reserved.
Use permitted only for educational and non-commercial purposes as part of the challenge.

---

📩 Contact & Support

📧 walker@aidkriya.com
🌐 www.aidkriya.com
📱 +91 98310 61039