https://github.com/ginabeki/budget-app
This expense management app, developed using Ruby on Rails, enables users to create new categories and record expenses within each category. As a result, you can easily generate a list of transactions associated with each category.
https://github.com/ginabeki/budget-app
Last synced: 25 days ago
JSON representation
This expense management app, developed using Ruby on Rails, enables users to create new categories and record expenses within each category. As a result, you can easily generate a list of transactions associated with each category.
- Host: GitHub
- URL: https://github.com/ginabeki/budget-app
- Owner: ginabeki
- License: mit
- Created: 2023-03-19T18:07:03.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-21T14:47:27.000Z (over 1 year ago)
- Last Synced: 2025-02-07T23:46:15.422Z (3 months ago)
- Language: Ruby
- Homepage:
- Size: 151 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📗 Table of Contents
- [📗 Table of Contents](#-table-of-contents)
- [📖 ExpenseApp ](#-expenseapp-)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [Preview](#preview)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [👥 Author ](#-author-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [📝 License](#license)
Expense App is an expenses management app created using Ruby on Rails. It allows a user to create new categories and create new expenses for each category thus you have a list of transactions associated with a category.
- User Registration.
- User login.
- Create Category: a user can create a category for his expenses.
- Create transaction(expense): a user can create a transaction that belongs to a specific category.
## Preview
To get a local copy up and running, follow these steps.
### Prerequisites
In order to run this project you need:
- IDE or code editor: **VsCode, atom, sublime**...
- To have [Ruby](https://www.ruby-lang.org/en/) and [Git](https://git-scm.com/) installed on your system.
- To have [Node.js](https://nodejs.org/) installed on your system.
After installing Ruby, run the following command to install rails.-
```sh
gem install rails
```
### Setup
Clone this project on your local machine using the following command in your terminal:
```sh
git clone https://github.com/ginabeki/Budget-app.git
```
### Install
Run the following command to install all project's dependencies:
```sh
cd Budget-app
bundle install
node install
```
### Usage
To run the project, execute the following command:
Example command:
```sh
rails server
```
OR
```sh
rails s
```
### Run tests
To run tests, run the following command:
Example command:
```sh
gem install rails rspec
rspec ./spec/models/
```
👤 **Gina Beki**
- GitHub: [@ginabeki](https://github.com/ginabeki)
- Twitter: [@gina](https://twitter.com/ginabeki)
- LinkedIn: [@ginabeki](https://www.linkedin.com/in/ginabeki/)
- **Deploy the project and make it available for every one.**
- **Advance the UI**
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](https://github.com/ginabeki/Budget-app/issues).
If you like this project, kindly give it a star ⭐️
- Microverse😉
- Ruby on Rails Documentation🙃
- Huge appreciation to [Gregoire Vella](https://www.behance.net/gregoirevella) for providing design system guidelines🙃
This project is [MIT](./LICENSE) licensed.