https://github.com/ansaribrahim/budget-app

Budget-App is a web-based application designed to help users manage their expenses and budgets effectively. It allows users to track their spending, categorize expenses, and set budget goals to achieve financial control.
https://github.com/ansaribrahim/budget-app

capybara-rspec deployment erb font-awesome gitflow html javascript license linters rails rspec rubocop ruby rubyonrails tailwindcss unit-testing

Last synced: 14 days ago
JSON representation

Budget-App is a web-based application designed to help users manage their expenses and budgets effectively. It allows users to track their spending, categorize expenses, and set budget goals to achieve financial control.

• Host: GitHub
• URL: https://github.com/ansaribrahim/budget-app
• Owner: AnsarIbrahim
• License: mit
• Created: 2023-10-16T07:51:24.000Z (about 1 year ago)
• Default Branch: dev
• Last Pushed: 2023-11-19T08:54:44.000Z (12 months ago)
• Last Synced: 2024-10-10T05:01:07.408Z (about 1 month ago)
• Topics: capybara-rspec, deployment, erb, font-awesome, gitflow, html, javascript, license, linters, rails, rspec, rubocop, ruby, rubyonrails, tailwindcss, unit-testing
• Language: Ruby
• Homepage: https://budget-app-b5ut.onrender.com/
• Size: 115 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        




    


# Budget-App

![e2954fb3deb2407e8e4bcb40b1fd6376](https://github.com/AnsarIbrahim/LeaderBoard-new/assets/117971223/9d715e43-a095-4b33-b5f2-161236e8fdcc)



## 📗 Table of Contents

- [📖 Blog app ](#-blog-app-)

  - [🛠 Built With ](#-built-with-)

    - [Tech Stack ](#tech-stack-)

    - [Key Features ](#key-features-)

    - [🚀 Live Demo ](#-live-demo-)

  - [💻 Getting Started ](#-getting-started-)

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

    - [Usage](#usage)

  - [👥 Author ](#-author-)

  - [🔭 Future Features ](#-future-features-)

  - [🤝 Contributing ](#-contributing-)

  - [⭐️ Show your support ](#️-show-your-support-)

  - [🙏 Acknowledgments ](#-acknowledgments-)

  - [📝 License ](#-license-)

# 📖 Budget-App 

**Budget-App** is a web-based application designed to help users manage their expenses and budgets effectively. It allows users to track their spending, categorize expenses, and set budget goals to achieve financial control.

## 🛠 Built With 

### Tech Stack 

  Frontend

    
HTML

    
TailwindCSS

    
JavaScript


  Server

    
Ruby

    
Rails


  Database

    
PostgreSQL


### Key Features 

- Create and manage expense categories.

- Add individual transactions.

- View transaction history for each category.

- Calculate and display the total amount spent within each category.

- Set budget goals for different expense categories.

(back to top)


## 🚀 Live Demo 

- [Live Demo Link](https://budget-app-b5ut.onrender.com/)

- [Video Walkthrough](https://www.loom.com/share/06c3cbaf70b74d25ad8584ade58698ce?sid=ee3da631-7d88-4dd9-9e93-65cdb2413524)

(back to top)


## 💻 Getting Started 

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

### Prerequisites

In order to run this project you need:

```

    ruby >= 3.2.0

    rails >= 7.0

    postgres >- 15.3

```

### Setup

Clone this repository to your desired folder:

```bash

  git clone https://github.com/AnsarIbrahim/Budget-App.git

```

You need to set up a database for these project

```

  development = budget_app_dev

  test        = budget_app_test

  production  = budget_app_production

```

or you can use your own database and change the ```config/database.yml```

```yml

  default: &default

    adapter: PostgreSQL

    encoding: Unicode

    pool: 5

    username: [your_username]

    password: [your_password]

    host: localhost

  development:

    <<: *default

    database: [your_database_for_development]

  test:

    <<: *default

    database: [your_database_for_test]

  production:

    <<: *default

    database: [your_database_for_production]

```

### Install

Install this project with:

```bash

  cd budget_app

  bundle install

```

it will install the required gem file for running the project

### Usage

to use this project:

```ruby

   rails server -p 3000

```

```

  rails tailwindcss:watch

```

it will run the server on ```localhost:3000```

(back to top)


## 👥 Author 

👤 **Ansar Ibrahim**

- [GitHub](https://github.com/AnsarIbrahim)

- [LinkedIn](https://linkedin.com/in/ansar-ibrahim/)

- [Twitter](https://twitter.com/ansaradheeb)

(back to top)


## 🔭 Future Features 

- [ ] Expense categories and tags

- [ ] Customizable spending categories

- [ ] Android and iOS app development

- [ ] Scheduled payment reminders

- [ ] API Documentation

(back to top)


## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/AnsarIbrahim/Budget-App/issues).

(back to top)


## ⭐️ Show your support 

If you like this project you can share this project to your friend

(back to top)


## 🙏 Acknowledgments 

> The original design idea for this web page was created by [Gregoire Vella on Behance](https://www.behance.net/gregoirevella).

- I would like to thank Microverse for defining these project requirements.

(back to top)


## 📝 License 

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

(back to top)