💸 Expense Tracker

A smart Android app to take control of your finances

Track your daily spending, monitor income vs expenses, and gain clear insights into your financial habits — all in one place.

🚀 Getting Started • ✨ Features • 🛠️ Tech Stack • 📁 Project Structure • 🤝 Contributing

---

✨ Features

Feature	Description
🏠 Home Dashboard	See total balance, income vs expenses at a glance with recent transactions
➕ Add Expense	Log any expense with amount, category, date, notes & payment method
💳 Payment Methods	Supports Cash, Credit Card, Debit Card, and Online payments
📊 Spending Summary	Visual spending overview with month-over-month chart and category breakdown
🗂️ Category Tracking	Auto-categorized spending (Food, Shopping, Transport, and more)
🔐 Secure Auth	Email/Password login + Sign in with Google via Firebase Auth
👤 User Profile	View your profile with name, email and one-tap logout
☁️ Cloud Sync	Real-time data sync across devices powered by Firebase
🌙 Dark Theme	Sleek, eye-friendly dark UI throughout the entire app
📅 Date & Range Filter	Filter transactions by date range and category

---

🛠️ Tech Stack

├── Language        →  Java
├── Platform        →  Android (Native)
├── Backend         →  Firebase (Authentication + Realtime Database / Firestore)
├── Build System    →  Gradle (Kotlin DSL)
└── Min SDK         →  Android 5.0+ (Lollipop)

Libraries & Tools:

• 🔥 Firebase Auth — User registration & login
• ☁️ Firebase Firestore / Realtime Database — Cloud data storage
• 🎨 Material Components — Modern Android UI
• 📦 JitPack — Third-party library resolution
• ⚙️ Google Services Plugin — Firebase integration

---

📁 Project Structure

ExpenseTracker/
│
├── app/
│   └── src/
│       ├── main/
│       │   ├── java/          # Java source files (Activities, Adapters, Models)
│       │   ├── res/           # Layouts, drawables, strings, styles
│       │   └── AndroidManifest.xml
│       └── test/              # Unit tests
│
├── build.gradle.kts           # Root Gradle config
├── settings.gradle.kts        # Project settings & dependencies
└── gradle.properties          # Gradle properties

---

🚀 Getting Started

Prerequisites

• ✅ Android Studio (Hedgehog or later recommended)
• ✅ JDK 11 or above
• ✅ A Firebase project set up at console.firebase.google.com

Installation

1. Clone the repository

git clone https://github.com/Hemanshu4949/ExpenseTracker.git
cd ExpenseTracker

2. Open in Android Studio

File → Open → Select the cloned folder

3. Configure Firebase

• Go to Firebase Console and create a new project
• Add an Android app with your package name
• Download google-services.json and place it in the app/ directory

4. Sync & Run

Sync Gradle → Run on Emulator or Physical Device

⚠️ Make sure you have Google Play Services installed on your emulator/device for Firebase to work.

---

📸 Screenshots

🔐 Login	🏠 Home Dashboard	➕ Add Expense
📊 Summary	👤 Profile & Settings

---

🔧 Configuration

To point the app to your own Firebase backend:

1. Replace app/google-services.json with your own from Firebase Console
2. Enable Email/Password Authentication in Firebase Auth settings
3. Set up Firestore or Realtime Database rules as needed

---

🤝 Contributing

Contributions, issues, and feature requests are welcome!

# Fork the repo, then:
git checkout -b feature/your-feature-name
git commit -m "Add: your feature description"
git push origin feature/your-feature-name
# Open a Pull Request 🎉

Please make sure your code follows standard Java/Android conventions and is tested before submitting.

---

📄 License

This project is open source. Feel free to use, modify, and distribute it.

---

👨‍💻 Author

Hemanshu Sojitra — @Hemanshu4949

---

⭐ If you found this project helpful, give it a star!

Made with ❤️ and Java for Android