lunch_money_companion's Introduction

Lunch Money Companion App

Introduction

Welcome to the Lunch Money Companion App, an Android application crafted by Rodrigo Lopes Martins. This app serves as an independent client for the Lunch Money personal finance service, aiming to provide Android users with a seamless experience in visualizing their financial data. Though not affiliated with Lunch Money, this app faithfully replicates the user experience of the official web application using Lunch Money's public APIs.

Key Features

Data Visualization: Display your financial data from Lunch Money in a clear and intuitive format.
User Privacy: No data collection or storage. Your information stays between you and Lunch Money.
Seamless User Experience: Mimics the layout and UX of the official Lunch Money web application for familiarity.

Technology Stack

Jetpack Compose: Modern UI toolkit for intuitive and responsive layouts.
Composition Root: Centralized place for all dependencies, enhancing maintainability and scalability.
Koin: A pragmatic lightweight dependency injection framework for Kotlin.
Kotlin: A modern, concise, and safe programming language.
kotlinx.coroutines: Asynchronous programming with Kotlin, making network calls smooth and efficient.
Retrofit: A type-safe HTTP client for Android and Java, simplifying API interactions.

Security & Privacy

No Internal Data Storage: The app does not store any personal data.
Direct API Interaction: Utilizes Lunch Money's public API with a user-provided token for secure data access.

Getting Started

To use the app, you will need an API token from Lunch Money. Follow these steps:

Visit the official Lunch Money website: Lunch Money
Obtain your API token from your account settings.
Enter this token in the app to securely sync your data.

Contributions

As an independent project, contributions, feedback, and suggestions are always welcome. Please reach out or submit pull requests for improvements.

Check out WIKI: Contributing Guidelines

Disclaimer

This application is not officially affiliated with Lunch Money. It is a personal project developed by Rodrigo Lopes Martins, intended to provide an alternative way for Android users to access their Lunch Money data.

Acknowledgments

A special thank you to the Lunch Money team for their open API and the inspiration they provide to the personal finance community.

lunch_money_companion's People

Contributors

Stargazers

Watchers

lunch_money_companion's Issues

Formatting issue with symbols on Budget screen

Describe the bug
There are issues with symbol formatting on the budget page, for example ampersands are replaced with their reference instead. & is replaced with & - These show correctly on the Transactions page

To Reproduce
Add a budget category using an & symbol and see it within the apps Budget page.

Expected behavior
For it to show the correct characters instead of the reference.

Screenshots
I can add a screenshot if necessary once I'm able to!

Smartphone (please complete the following information):
Using a Samsung S23 Ultra

Additional context
None.

Transaction data fails to load

Total income and expenses differ greatly from website

Describe the bug
My income and expenses per month differ greatly between the website and the app, not only are both significantly (incorrectly) higher in the app (nearly double), the profit/loss calculation also does not come to the same answer.

I think this might be because of "hidden" transactions, I do a lot of account to account transfers (just sorting payments through bank accounts) and I have a specific category for this so they don't show up in the overview as the money never actually got spent, just moved around.

To Reproduce
Steps to reproduce the behavior:
Not sure, but probably making some transactions and assigning them to a "hidden" category does this

Expected behavior
The total expenses and income being exactly the same as on the desktop website.

Smartphone (please complete the following information):

Device: Samsung Galaxy Z Flip 5
OS: Android 14 (OneUI 6.1)
Version: 1.6.4

rodrigolmti / lunch_money_companion Goto Github PK