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

https://github.com/mohamedsabry0/inqezwallet

InqezWallet is a budget tracking app designed to assist users in managing their finances efficiently. The app enables users to track their expenses, and budget goals effectively.
https://github.com/mohamedsabry0/inqezwallet

budget-app rails7 ruby

Last synced: 2 months ago
JSON representation

InqezWallet is a budget tracking app designed to assist users in managing their finances efficiently. The app enables users to track their expenses, and budget goals effectively.

Awesome Lists containing this project

README

        

InqezWallet


InqezWallet screenshot

# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)
- [📖 About InqezWallet ](#-about-inqezwallet-)
- [Live Demo](#live-demo)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [👤 Author ](#-author-)
- [🔭 Future Features ](#-future-features-)
- [Features in progress working on ](#features-in-progress-working-on-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show Your Support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)

# 📖 About InqezWallet

InqezWallet is a budget tracking app designed to assist users in managing their finances efficiently. The app enables users to track their expenses, and budget goals effectively.

# Live Demo

[Demo](https://inqez-wallet.onrender.com)
[video](https://www.loom.com/share/fa8d0563178c4b5fb19fc4849d3670bd?sid=657c532b-01e2-4f63-8fa7-58a891c2f6e8)

## 🛠 Built With

### Tech Stack

Client

Server

Database

### Key Features

- Track expenses.
- Categorize transactions for better insights.
- User-friendly interface for easy navigation.
- Server-side validations for data integrity.

(back to top)

## 💻 Getting Started

To get started with InqezWallet, follow the steps below:

### Prerequisites

Ensure you have the following prerequisites installed:

- Ruby 3.2.2
- Bundler 2.5.1

### Setup

Clone this repository to your desired location:

```
git clone https://github.com/mohamedSabry0/inqezWallet.git
cd inqezWallet
```

### Install

Install project dependencies:

```
bundle install
bin/rails db:create
bin/rails db:migrate
```

### Usage

Compile assets and start the server:

```
yarn build:css
bin/rails server
```

### Run tests

Run tests using:

```
rspec --format doc
```

## 👤 Author

👤 **Mohamed Sabry**

- GitHub: [@mohamedSabry0](https://github.com/mohamedSabry0)
- Twitter: [@mohsmh0](https://twitter.com/mohsmh0)
- LinkedIn: [in/mohamed-sabry0](https://www.linkedin.com/in/mohamed-sabry0/)

## 🔭 Future Features

- [ ] Adding some UX improvements: transitions and/or animations, etc.
- [ ] Implementing a decent desktop design for the webapp.
- [ ] Implementing the left side menu to improve the navigability of the app.
- Set and monitor budget goals.
- View detailed financial reports.
- Track income.
- Add support for reports sharing.
- Add input client side validations for UX.
- Add conditional root path, based on session status.
- Native icon upload support.
- Add support for multiple currencies.
- Add support for multiple languages.

## Features in progress working on

- [ ] Improving and refactoring tests for more coverage and expressiveness.

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](link-to-issues).

## ⭐️ Show Your Support

If you find InqezWallet helpful, kindly show your support by giving it a star or providing feedback for further improvements.

## 🙏 Acknowledgments

- [Design idea by Gregoire Vella on Behance](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding)
- Device Mockup created from [iPhone mockups](https://deviceframes.com/templates/iphone-13)
- [Microverse](https://www.microverse.org/)
- [Rails Guides](https://guides.rubyonrails.org/)
- [Stack Overflow](https://stackoverflow.com/)
- [css-bundling-rails](https://github.com/rails/cssbundling-rails)
- [Testing HTML form validation](https://stackoverflow.com/a/48206413)
- Icons:
- Done icons created by LAFS - Flaticon

(back to top)

## 📝 License

This project is licensed under the [MIT License](./LICENSE).

(back to top)