Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/enrique-lozano/Monekin
A 100% Open Source app that tries to make personal finances easier. Fast, simple, without ads, without the need for an Internet connection and with a groundbreaking design, that's Monekin.
https://github.com/enrique-lozano/Monekin
finance-management flutter-app hybrid-app material-design money-manager open-source personal-finances
Last synced: 5 days ago
JSON representation
A 100% Open Source app that tries to make personal finances easier. Fast, simple, without ads, without the need for an Internet connection and with a groundbreaking design, that's Monekin.
- Host: GitHub
- URL: https://github.com/enrique-lozano/Monekin
- Owner: enrique-lozano
- License: agpl-3.0
- Created: 2022-12-14T20:01:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-05T22:52:12.000Z (8 days ago)
- Last Synced: 2024-11-05T23:31:27.374Z (8 days ago)
- Topics: finance-management, flutter-app, hybrid-app, material-design, money-manager, open-source, personal-finances
- Language: Dart
- Homepage:
- Size: 24 MB
- Stars: 59
- Watchers: 3
- Forks: 15
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Monekin - Official repository
Monekin is a 100% Open Source app that tries to make personal finances easier. Fast, simple, without ads, without the need for an Internet connection and with a groundbreaking design, that's Monekin.
Start exploring »
Table of Contents
## About the project
| | | | |
| :----------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------: |
|  |  |  |  |
|  |  |
### Why Monekin?
After a lot of research on the marketplaces I could not find any application that met all my needs. That is why I decided to start making my own app. After months of hard work, the first version was released on Google Play in October 2021. I decided to make it 100% Open Source shortly after, with the aim of increasing its user community, and that external developers could help and collaborate with me on the project. Since the day of its release, the app has been continuously improving and updating.
### Tech Stack
At the beggining the app was developed in Ionic and Angular. In 2023, in order to make our app better, we migrate the app to Flutter, which allow us to have a modern and scalable application for a large number of operating systems and platforms.
To store and persist your data in the app we store a SQLite database directly in your device, thanks to an opensource package called [drift](https://github.com/simolus3/drift)
## Run the code locally 🚀🧑💻
The following explains how to run the project code locally. This way you will be able to investigate on your own how it is done, create new features, fix bugs, etc.
### Prerequisites
As with any Flutter project, you need to install the framework in your machine. Visit the [official docs](https://docs.flutter.dev/get-started/install) for more info. You should also have git installed in your machine.
### Installation
Open a terminal on your computer and go to the folder where you want to place the project. Then clone the project and install the dependencies by typing the following commands:
```
git clone https://github.com/enrique-lozano/Monekin.git
```
```
cd Monekin
```
```
flutter pub get
```
If everything went correctly these commands will finish executing without errors. Now you can run flutter run on your terminal to open the app locally in your device. The app will be refreshed when changes in the code appear. Before making any changes into the code is recommended to read the [code contribution guide](https://github.com/enrique-lozano/Monekin/blob/main/docs/CODE_CONTRIBUTING.md)
## Contributing 🙋🏻
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make here are **greatly appreciated**.
Read through our [contributing guidelines](https://github.com/enrique-lozano/Monekin/blob/main/CONTRIBUTING.md) to learn about how you can collaborate making Monekin better. **All Pull Requests are welcome** and will be studied without exception!
### Why to contribute?
- We can learn for you and you can learn from us.
- You'll appear in our contributors wall.
- You can **include it in your CV/LinkedIn** and show recruiters that you contribute to open-source projects.
- You'll make Monekin better.
- You can develop the features that you miss in the app yourself, the way you want them.
- You'll play around and learn cutting-edge technologies.
- It's the easiest way to learn Flutter/Dart... in a production environment.