Skip to content

Latest commit

 

History

History
130 lines (96 loc) · 9.56 KB

README.md

File metadata and controls

130 lines (96 loc) · 9.56 KB
Raw

GreenStash

GitHub GitHub code size in bytes Project Status: Active – The project has reached a stable, usable state and is being actively developed. build-workflow

GreenStash is a simple FOSS android app to help you plan and manage your savings goals easily and establish the habit of saving money.

Important Note (Don't ignore); If you were using any previous version before v2.0, please DO NOT UPDATE and do CLEAN INSTALLATION (by uninstalling the <= v1.9 and installing >= v2.0 ) instead. As the app has been completely re-written from scratch in v2.0 release with an entirely new database schema, redesigned UI/UX and reworked backend. Hence, this release is not compatible with the older versions.

Donations

If this project helped you a little bit, please consider donating a small amount to keep the projects going, Your donations helps ensure that my open source projects are actively maintained. You can donate via following mediums:

Github-sponsors Bitcoin Ethereum

Or you could just buy the app from Google Play Store. You'll get constant updates without the need to get all the way here and download the release all by yourself and install the release all by yourself and then you realize you have a different package name so you contact me but I really don't have time for this so I update it on google play and then you realize your installer doesn't work and then you realize your whole life is like this, miserable and not working but then you see a point of light in the distance so you run towards and it's the "Buy" button in the GreenStash's page on google play, it'll make your life easier.

Downloads

Get it on Google Play Get it on F-Droid Get it on IzzyOnDroid Get it on GitHub

Screenshots

Highlights

  • Clean & beautiful UI based on Google's material design three guidelines.
  • Add images to your saving goals to keep you motivated!
  • View how much you need to save daily/weekly/monthly to achieve your goal before deadline.
  • View detailed transaction (withdraw/deposit) history.
  • Supports around 100+ local currency symbols.
  • Inbuilt biometric app lock to keep your financial data safe and secure.
  • Fully offline, greenstash doens't require internet permission to work.
  • Compatible with Android 7.0 and above (API 24+)
  • Supports Material You theming in devices running on Android 12+
  • Comes in both light and dark mode.
  • MAD: UI and logic written with pure Kotlin. Single activity, no fragments, only composable destinations.

Translations

If you want to make app available in your language, you're very welcome to create a pull request with your translation file. The string resources can be found under /app/src/main/res/values/strings.xml. It is easiest to make a translation using the Android Studio XML editor, but you can always go with your favorite XML-text editor instead. Checkout this guide to learn more about translation strings from Helpshift for Android.

Tech Stack

  • Kotlin - First class and official programming language for Android development.
  • Coroutines - To improve performance by doing I/O tasks out of main thread asynchronously.
  • Flow - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.
  • Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
    • Jetpack Compose - Jetpack Compose is Android’s recommended modern toolkit for building native UI
    • LiveData - Data objects that notify views when the underlying database changes.
    • ViewModel - Stores UI-related data that isn't destroyed on UI changes.
  • Lottie - Lottie is an Android, iOS and React Native library that renders After Effects animations in real time.
  • Coil - An image loading library for Android backed by Kotlin Coroutines.
  • Dagger-Hilt For Dependency injection (DI)
  • Room database - Persistence library provides an abstraction layer over SQLite to allow for more robust database access while harnessing the full power of SQLite.

License

MIT License © Stɑrry Shivɑm

MIT License

Copyright (c) [2022 - Present] Stɑrry Shivɑm

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.