Personal Ledger

Track your personal expense, investments and assets to help you understand what you have and to make informed decisions..
Explore the Docs · Report a Bug · Request a Feature

Personal Ledger aims to provide its users with an intuitive and user-friendly interface that offers insights into their spending habits and investment position. By presenting information clearly and concisely, users can effectively monitor their overall financial health, make informed decisions, and ultimately achieve their personal financial goals.

Motivation for Personal Ledger:

• Applications in general are opinionated, and finance applications are no different. Looking at the finance applications available, none ticked my boxes or were monthly subscription models with high fees.
• I niavely thought I could do it better.
• Funsy project to hone my programming skills.

(back to top)

The Personal Ledger has a number of standalone applications and services that can be combined to suit your preference. They include the following:

• Backend (Underdevement) : A backend server that can be accessed by front ends through an rpc interface. The backend can be a standalone binary service or Docker deployable.
• Web (Under Development) : A web frontend app that uses the backend for data quering. The web frontend can be a standalone binary service or Docker deployable
• Desktop (Planned) : A desktop app that wraps the web front end that can access the bakend or be standalone.
• TUI (Planned) : A text interface frontend that can access the backend or be standalone.

I have tried to keep the tech stack with Rust, because that is what I would like to learn and improve with. The Rust stack being used includes the following:

• Sqlite:
• Tonic:
• Tuari:
• Ratui:

(back to top)

At the moment Personal Ledger is under development, so no Getting Started or Prerequisites are available.

To get started with Personal Ledger run the following commands.

$

To install Personal Ledger run the follwing commands.

$

(back to top)

This space will be used to show useful examples of how a project can be used. Additional screenshots, code examples and demos work.

Include any links to more resources.

For more examples, please refer to the Documentation

(back to top)

• Map out the development workflow
• Develop REST API server (backend) minimum viable product
• Develop web server (frontend) minimum viable product
• Develop deployment integration
• Work through feature set:
  • Feature 1
  • Feature 2

See the Personal Ledger - Roadmap for a full list of proposed features.

(back to top)

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Distributed under the GPL3.0 License. See LICENSE.txt for more information.

(back to top)

• Ian Teda - [email protected]
• Project Link: https://github.com/IanTeda/personal-ledger

(back to top)

The following is a list of resources you find helpful and would like to give credit to:

• Choose an Open Source License
• Img Shields
• GitHub Pages
• Best README Template

(back to top)

Below is a list of similar applications that you might prefer to use:

• GNU Cash
• KmyMoney
• Money Manager EX
• Firefly III
• You Need A Budget (YNAB)
• Mint
• Beancount
• Plain Text Accounting
• BudgE
• Budget Zero
• Buckets

(back to top)