Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/piercel2022/budget_app

PIERCEL-BUDGET is a mobile web application where a user can manage the budget, and can easily create an account, login and start managing his budget. The features of the web application are: The user authentication to create an account and then login. The user can add some transactions according to the category of the transactions.
https://github.com/piercel2022/budget_app

bootstrap5 postgresql rails7 render ruby ruby-on-rails

Last synced: about 1 month ago
JSON representation

PIERCEL-BUDGET is a mobile web application where a user can manage the budget, and can easily create an account, login and start managing his budget. The features of the web application are: The user authentication to create an account and then login. The user can add some transactions according to the category of the transactions.

Awesome Lists containing this project

README

        

REQUIRED SECTIONS:
- Table of Contents
- About the Project
- Built With
- Live Demo
- Getting Started
- Authors
- Future Features
- Contributing
- Show your support
- Acknowledgements
- License

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#triangular_flag_on_post-deployment)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ](#faq)
- [📝 License](#license)

![budget](https://github.com/Piercel2022/budget_app/assets/98626003/ce019d00-2726-4de7-ab53-9e7bbc7fc629)

**[Piercel Budget]** is a mobile web application where you can manage your budget and you can easily create an account and login to start managing your budget. A user can create categories to keep track of specific expenses and add transactions to those groups to stay on top of the spending. With this app, you can stay in top of list when coming up with financial plan. This app is deployed online and you can check it.

## 🛠 Built With

### Tech Stack

Rails is a full-stack framework. It ships with all the tools needed to build amazing web apps on both the front and back end.

Bootstrap is the most popular CSS Framework for developing responsive and mobile-first websites.

PostgreSQL is a powerful, open source object-relational database system with over 35 years of active development that has earned it a strong reputation for reliability, feature robustness, and performance.
The World's Most Advanced Open Source Relational Database

### Key Features

- **[Account creation]**
- **[Category creation]**
- **[Transaction creation]**
- **[Budget tracking]**

(back to top)

## 🚀 Live Demo

- [Live Demo](https://budget-app-0eev.onrender.com/)

## Project presentation

- [Video Demo Link](https://www.loom.com/share/b28b5ff3497b4b8d97ab104052bc20f4)

(back to top)

## Project Presentation

## 💻 Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

```sh
gem install rails
```
Ruby, rails and postgresql installed
### Setup

Clone this repository to your desired folder:

```sh
git clone [email protected]:Piercel2022/budget_app.git
cd budget_app
```
### Install

Install this project with:

```sh
bundle install
```
### Usage

To run the project, execute the following command:

```sh
rails server
```
### Run tests

To run tests, run the following command:

```sh
bin/rails rspec
```

(back to top)

## 👥 Author

👤 **Pierre Celestin Moussa**

- GitHub:[@Piercel2022](https://github.com/Piercel2022)
- Twitter:[@pier_celestin](https://twitter.com/pier_celestin)
- LinkedIn: [@pierrecelestinmax](https://linkedin.com/in/pierrecelestinmax)

(back to top)

## 🔭 Future Features

- [ ] **[Modify and delete button on category]**
- [ ] **[Modify and delete button on transaction]**
- [ ] **[Improve the user interface of the app]**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

(back to top)

## ⭐️ Show your support

If you like this project...

(back to top)

## 🙏 Acknowledgments

I would like to thank...

  • Gregoire Vella on Behance
  • ## 📝 License

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