https://github.com/qwibbler/econome

A budgeting app, where you can put in your daily expenditure, sort it into categories, and then see the breakdown of the expenditures per category. Made with Ruby on Rails.Rails Capstone Project
https://github.com/qwibbler/econome

rails7 ruby-on-rails

Last synced: 7 days ago
JSON representation

A budgeting app, where you can put in your daily expenditure, sort it into categories, and then see the breakdown of the expenditures per category. Made with Ruby on Rails.Rails Capstone Project

• Host: GitHub
• URL: https://github.com/qwibbler/econome
• Owner: qwibbler
• Created: 2022-06-27T18:33:21.000Z (over 2 years ago)
• Default Branch: dev
• Last Pushed: 2023-06-21T08:42:28.000Z (over 1 year ago)
• Last Synced: 2024-11-02T16:25:27.644Z (11 days ago)
• Topics: rails7, ruby-on-rails
• Language: Ruby
• Homepage: http://146.190.214.105
• Size: 823 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
![](https://img.shields.io/badge/Microverse-blueviolet)

# EconoMe

> A budgeting app, where you can put in your daily expenditure, sort it into categories, and then see the breakdown of the expenditures per category. Made with Ruby on Rails.

# [Live Demo](http://146.190.214.105/)

![splash_page](./app/assets/images/home.png)

 |   |   |   |

 | - |:-:| -:|

 |![category_page](./app/assets/images/categories.png) | ![transactions_page](./app/assets/images/transactions.png) | ![details_page](./app/assets/images/details.png) |

## Built With

- Ruby 3.1.2

- Rails 7.0.3

- Rubocop

- Devise

- Rspec

- Capybara

## Getting Started

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

### Prerequisites

- Ruby

- PostgreSQL

- RubyGems

- Node.js

- Yarn

- Rails

### Setup

- Clone the repository using `git clone https://github.com/qwibbler/blogoverse`.

- `cd` into the project folder.

- Update your database credentials in the `\config\database.yml`.

### Install

- Run `bundle install` in your terminal to install all the required dependencies.

- Run `rails db:setup` to configure your database.

- Run `rails s` to start the server.

- Go to `localhost:3000` (or whatever port the server is listening on).

### Usage

- You can sign up with new user, or log in if you already have an account.

- You will start with some default categories, but you can add as many new ones as you like.

- You can add an icon to each category, to quickly and easily recognize it.

- You can view all the utransactions in a given category as well as their total price.

- You can vieweach individual transaction in detail.

### Run tests

- Run `rails db:seed RAILS_ENV=test` to seed the test database.

- Run `rspec` in your terminal.

## Authors

👤 **Humaira Zaman**

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

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

- LinkedIn: [Humaira Zaman](https://www.linkedin.com/in/hmemaz1994/)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

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

## Show your support

Give a ⭐️ if you like this project!

## Acknowledgments

- Original design idea by [Gregoire Vella on Behance](https://www.behance.net/gregoirevella).

- Icons taken from [Flaticon](https://www.flaticon.com/).

## 📝 License

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