Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/grace-rasaily780/boringfinance

Boring Finance: Fancy Record Keeping
https://github.com/grace-rasaily780/boringfinance

elysiajs finance finance-management foss javascript opensource zustand

Last synced: 7 days ago
JSON representation

Boring Finance: Fancy Record Keeping

Host: GitHub
URL: https://github.com/grace-rasaily780/boringfinance
Owner: Grace-Rasaily780
License: gpl-3.0
Created: 2024-10-18T08:14:46.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-12-02T07:05:32.000Z (about 1 month ago)
Last Synced: 2024-12-27T03:08:53.823Z (7 days ago)
Topics: elysiajs, finance, finance-management, foss, javascript, opensource, zustand
Language: TypeScript
Homepage: https://boring-finance.vercel.app/
Size: 771 KB
Stars: 63
Watchers: 3
Forks: 12
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        



[![Contributors](https://img.shields.io/github/contributors/Grace-Rasaily780/boringfinance?style=for-the-badge

)](https://github.com/Grace-Rasaily780/boringfinance/graphs/contributors)

[![Issues](https://img.shields.io/github/issues/Grace-Rasaily780/boringfinance?style=for-the-badge

)](https://github.com/Grace-Rasaily780/boringfinance/issues)

[![Stars](https://img.shields.io/github/stars/Grace-Rasaily780/boringfinance?style=for-the-badge)](https://github.com/Grace-Rasaily780/boringfinance/stargazers)

[![MIT License](https://img.shields.io/github/license/Grace-Rasaily780/boringfinance?style=for-the-badge)](https://github.com/Grace-Rasaily780/boringfinance/blob/main/LICENSE.txt)

[![LinkedIn](https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555)](https://www.linkedin.com/in/grace-rasaily-a53263206/)








  

    

  

  
Boring Finance: Fancy Record Keeping



  


  A minimalist and modular finance tracking web application that implements the 50-30-20 budgeting rule

  


  


    Use Web App

    -

    Report Bug

  





  Table of Contents

  


    

      About The Project

      

        Built With

      

    

    Usage

    Roadmap

    Contributing

    License

    Contact

    Acknowledgments

  


## About The Project

[![Mobile Screen Shot](assets/mobile_screen.png)](assets/mobile_screen.png)

[![Laptop Screen Shot](assets/large_screen.png)](assets/large_screen.png)

Boring Finance is a minimalist and modular finance tracking web application designed to simplify budgeting using the 50-30-20 rule. The project aims to provide a clean, intuitive interface for users to manage their finances effectively while offering flexibility for future enhancements.

Key features:

* Dashboard showing total budget breakdown (50/30/20 allocation)

* Activity feed for tracking transactions

* Transaction entry and management

* Settings for budget customization

The 50-30-20 rule is a simple budgeting method that allocates:

* 50% of income to needs

* 30% to wants

* 20% to savings

This application helps users visualize and maintain this allocation easily.

(back to top)


### Modularity

Boring Finance aims to achieve a modular architecture, allowing for:

1. Easy addition of new features and components

2. Flexibility in customizing existing modules

3. Potential for users to enable/disable specific features

4. Simplified maintenance and updates

5. Possibility of third-party module development in the future

This modular approach ensures that Boring Finance can evolve with user needs and adapt to various financial management strategies beyond the initial 50-30-20 rule implementation.

(back to top)


### Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

* React.js

* Elysia.js

* Bun

* Shadcn UI

* MongoDB

(back to top)


## Roadmap

- [ ] Category-based expense tracking

- [ ] Multiple currency support

- [ ] Modular architecture for easy expansion and customization

See the [open issues](https://github.com/Grace-Rasaily780/boringfinance/issues) for a full list of proposed features (and known issues).

(back to top)


## Contributing

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

### Top contributors:



  



(back to top)


## License

Distributed under the GLP-3.0 License. See `LICENSE.txt` for more information.

(back to top)


## Contact

Grace Rasaily - [@GraceRasaily](https://www.linkedin.com/in/grace-rasaily-a53263206/) - [email protected]

Project Link: [https://github.com/Grace-Rasaily780/boringfinance](https://github.com/Grace-Rasaily/boringfinance)

(back to top)


## Acknowledgments

* [Shadcn UI](https://ui.shadcn.com)

* [Currency Code API](https://github.com/carlosvin/currencies-map)

* [Zustand](https://zustand-demo.pmnd.rs)

* [Best-README-Template](https://github.com/othneildrew/Best-README-Template)

(back to top)