Skip to content

ruialmeida51/lumbridge-android

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kotlin Multiplatform

There's an ongoing effort to translate the app into Kotlin Multiplatform, giving access to a wider audience. The idea is to create Desktop, Web, Android & iOS apps from this. More information will be posted here: https://github.com/ruialmeida51/lumbridge-kmp

This one will keep being maintainted with the IRS Tables, but probably no new features will be added for the time being.

Loom (Previously Lumbridge) - Android Day-to-Day App

Loom is a simple financial app built for Android using and learning Jetpack Compose. It was created as a passion project to help manage day-to-day tasks and is open-source just for the love of the game, but eventually grew to a more solid piece. If you're interested, feel free to use it, improve it, or fork it!


🎯 Project Purpose

As stated before, it started a playground for me to learn and experiment with Jetpack Compose and modern Android development. However, my SO and friends around me saw use in this so I decided to keep adding features to it that they found useful. Eventually, it grew to a sizeable app, enough to be shared with everyone. I stand that open-source is the way to go, and I probably made and will continue to make a bunch of mistakes and less optimal choices during this development but, as coding usual is, this is a best effort to provide both learning material if anyone finds it interesting enough and a way to find people willing to contribute if they so desire. It's entirely open to more contributions, feature requests, and improvements!


⚠️ Disclaimer πŸ‡΅πŸ‡Ή

Please note: The Net Salary Calculator and Tax Calculations in Loom are currently tailored to Portugal's tax system. As such, they may not be accurate or applicable to other countries. I made this so other countries calculations can be added with "relative ease", and quotes are mandatory here as it's nevery easy to introduce an entirely new tax system into an app. But if you feel that's the only thing missing to use the app, why not create it yourself? πŸ˜„


πŸ’‘ Some notable features

Feed

  • πŸ—žοΈ Dynamic RSS Feed, customizable with your links

Tools

  • πŸ›οΈ Shopping Lists for day-to-day shopping & tracking
  • πŸ—’οΈ Notes for mental scribbles
  • πŸ—“οΈ Reminders for tasks with a subset of notification timings
  • πŸ”ƒ Recurring Payments
  • πŸ’° Net Salary Calculator
  • πŸ’± Currency Converter

Expenses

  • πŸ’Έ Keep track of your expenses and surplus money
    • Optional allocation versus spending tracking available.

Overview

  • βš–οΈ Check your balance with a cummulative view of money in versus money out.
  • 🏦 Keep track of your loans, how much you'll pay on the next cycle, their status, how much you still owe, etc.
  • πŸ’° Create a financial profile where you can see how much your net salary is, allocate your earnings and understand your deductions.

Profile

  • πŸ§’ Create your user profile and select country of choice.
  • βš™οΈ Define app settings such as: Locale, Enable/Disable Notifications, Enable/Disable Dark Mode
  • πŸ§‘β€πŸ’»Check source code & give feedback
  • .. other redundant pages such as edit loans & edit financial profile.

πŸ“± Play Store

You can download Lumbridge from the Google Play Store: Lumbridge on Play Store


πŸ“· Screenshots

feed tools expenses overview profile
image image image image image

πŸ› οΈ Tech Stack

  • Jetpack Compose: The entire UI is built with Jetpack Compose
  • Kotlin: Developed entirely in Kotlin
  • MVVM: Implements the MVVM architectural pattern.
  • Retrofit: Handles networking operations.
  • Room: Provides a robust database solution for local data persistence.
  • DataStore: Manages key-value pairs and typed objects for data storage
  • BuildSrc (Gradle): Utilizes buildSrc for managing Gradle dependencies and build logic
  • Others: Amongst other less famous dependencies. Feel free to check build.gradle to know more.

πŸ™Œ Contributions & Feedback

This app is open-source because I believe it's a way to give back to the community. So, contributions are always welcome! If you find any bugs, have suggestions, or want to add new features, feel free to open an issue or submit a pull request.

  • Report issues or feature requests on the Issues page
  • Fork/Clone the repo and submit any new feature, bugfix or improvement you may find relevant!
  • Feedback and suggestions are always highly appreciated!

β˜• Buy Me a Coffee

If you enjoy Lumbridge or find it useful, feel free to buy me a coffee for the late nights!

Buy Me A Coffee


πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


Happy coding, and thanks for checking out Loom! πŸŽ‰

About

Lumbridge AppπŸ°πŸ“• The home for my Android utility project. Made with πŸ’š and β˜•

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages