https://github.com/sachin-bi/spendwise-kotlin-spendings-tracker
SpendWise is a lightweight Kotlin-based app that empowers you to track your expenses and manage your finances with ease.
https://github.com/sachin-bi/spendwise-kotlin-spendings-tracker
app kotlin-android
Last synced: 4 months ago
JSON representation
SpendWise is a lightweight Kotlin-based app that empowers you to track your expenses and manage your finances with ease.
- Host: GitHub
- URL: https://github.com/sachin-bi/spendwise-kotlin-spendings-tracker
- Owner: sachin-bi
- Created: 2024-12-01T19:55:45.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-01-23T14:23:08.000Z (4 months ago)
- Last Synced: 2025-01-23T14:28:55.836Z (4 months ago)
- Topics: app, kotlin-android
- Language: Kotlin
- Homepage: https://www.linkedin.com/in/sachinandanp5/
- Size: 149 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SpendWise: Kotlin Spendings Tracker
SpendWise is a lightweight Kotlin-based app that empowers you to track your expenses and manage your finances with ease. It offers a user-friendly interface, insightful analytics, and features like bank message filtering, categorized spendings, and more to help you stay on top of your spending habits.
## Features
- **Bottom Navigation Bar**
- **Home Page**: Overview of your spending patterns.
- **Statement Page**: Detailed list of all transactions.
- **Message Page**: Filters bank-related SMS for quick insights.
- **User Page**: Personalized user profile and settings.
- **Bank Message Filtering**
- Intelligent filtering of bank-related SMS based on sender patterns and keywords.
- Clear separation of bank messages from general SMS.
- **Modern UI/UX**
- Intuitive and seamless navigation with a bottom navigation bar.
- Attractive and responsive design optimized for all screen sizes.
- **Permissions Management**
- Efficient handling of SMS permissions to ensure data privacy and security.
## Screenshots
| Home Page | Bank Messages | User Profile |
|----------------------------|------------------------------|----------------------------|
|  |  |  |
## Installation
1. Clone the repository:
```bash
git clone https://github.com/your-username/SpendWise-kotlin-spendings-tracker.git
```
2. Open the project in Android Studio.
3. Build and run the app on your device or emulator.
## Permissions
This app requires the following permissions:
- **SMS Permission**: To access and filter bank messages.
Ensure that permissions are granted for optimal functionality.
## Technologies Used
- **Kotlin**: Language for app development.
- **Android SDK**: Platform for building native Android apps.
- **Custom Adapters**: For displaying SMS data in ListViews.
- **Fragments**: Modular UI design with separate screens for ease of navigation.
## How It Works
1. **Home Page**:
- Displays an overview of expenses and quick links to other features.
2. **Message Page**:
- Extracts and filters bank-related messages using regex patterns.
- Displays bank messages in a user-friendly format.
3. **User Page**:
- Showcases user details and allows for settings customization.
4. **Statement Page**:
- Lists all transactions with date and message details.
## Contribution
Contributions are welcome! Feel free to fork the repository and submit pull requests with enhancements or bug fixes.
### Steps to Contribute:
1. Fork the repo.
2. Create a new branch for your feature/bugfix:
```bash
git checkout -b feature-name
```
3. Commit your changes:
```bash
git commit -m "Add your message here"
```
4. Push to your branch:
```bash
git push origin feature-name
```
5. Open a pull request.
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/sachin-bi) file for details.
---
### About SpendWise
SpendWise is built with a vision to simplify personal finance management by seamlessly integrating SMS-based transaction tracking and an intuitive user experience. Join us in revolutionizing the way you handle your finances!
---
**Contact Us:**
- Developers: [Akshat](https://github.com/sachin-bi), [Greeny](https://github.com/sachin-bi), [Sachin](https://github.com/sachin-bi)
- Email: [email protected]