Roopay
_{Mobile financial services — Android · Kotlin}

---

Overview

Roopay is a native Android application written in Kotlin. It brings banking-style tools, digital wallets, bill payments, travel booking shortcuts, and e-governance services into one streamlined experience. Authentication and cloud sync lean on Firebase, while payments can integrate through Razorpay; backend APIs are consumed via Retrofit.

---

Highlights

Area	What you get
Auth & profile	Sign up / login flows, profile management, optional location capture
Wallets	Roopay wallet, AEPS wallet, top-up, payout, QR
Banking & cash	Cash withdrawal, mini statement, balance check, Aadhaar Pay, DMT, loans, MATM, and more
Utilities	Mobile & DTH recharge, electricity, LIC, credit cards, Fastag, bills
Travel	Bus, train, and flight booking entry points
E‑governance	PAN (UTI / NSDL) and related services
Dashboard	Bottom navigation: Home, Settlements, Reports, Menu — plus drawer access to KYC, support, settings

---

Tech stack

Layer	Technologies
Language	Kotlin
UI	XML layouts, Material Components, View Binding
Architecture	Activities & Fragments, ViewModel, LiveData, Navigation Component
Async	Kotlin Coroutines
Networking	Retrofit 2 + Gson, OkHttp logging
Backend / auth	Firebase (Authentication, Firestore, Storage)
Payments	Razorpay Checkout SDK
Media & UX	Glide, Circle ImageView
Location	Google Play Services — Location
Build	Gradle (Kotlin DSL), Android Gradle Plugin 8.x

Minimum SDK: 24 · Target / compile SDK: 36

---

Project structure (overview)

app/src/main/java/com/example/roopayapp/
├── ui/auth/          # Login, Sign up
├── ui/dashboard/     # Main shell, fragments (Home, Menu, Reports, Settlements)
├── ui/profile/       # User profile
├── network/          # API service & Retrofit client
├── repository/       # Data layer
├── viewmodel/        # Auth ViewModel
├── models/           # API & user models
└── utils/            # Constants, location, Razorpay, progress helpers

---

Getting started

Prerequisites

• Android Studio (recommended: latest stable)
• JDK 11+
• Android SDK with API 36 (or matching compileSdk in app/build.gradle.kts)

Setup

1. Clone the repository.
2. Open the project in Android Studio and let Gradle sync.
3. Place your google-services.json under app/ (Firebase console → Project settings → Your apps).
4. Configure any API base URLs or keys your backend requires (see Constants / RetrofitClient as needed).
5. For Razorpay, ensure keys are supplied where your integration expects them.

Build & run

./gradlew assembleDebug

Install on a device or emulator from Android Studio, or:

./gradlew installDebug

---

Permissions (summary)

The app may request internet, fine/coarse location, camera, and storage/media access where features require them — see AndroidManifest.xml for the authoritative list.

---

Security note

Do not commit production API keys, Razorpay secrets, or private Firebase configs to public repositories. Use environment-specific configs or CI secrets for release builds.

---

License

Specify your license here (e.g. MIT, Apache-2.0, or proprietary).

---

Acknowledgements

Built with Kotlin and the Android platform; powered by Firebase, Razorpay, and open-source Android libraries.

_{Made with Kotlin · Material Design · Firebase}