Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/ksigei/budget_app


https://github.com/ksigei/budget_app

database heroku rails ruby

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

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

# Budget_app

> This is a budget app that allows you to add your income and expenses and it will calculate your balance.

## Built With

- Major: Ruby, HTML,CSS
- Frameworks: `Rails`, `Tailwind CSS`
- Libraries: `Cancancan`, `Devise`
- Technologies: Git, Gitflow, Linters, Github, PostgreSql, Rspec, Capybara, Robocop
## Sreenshots
![Opera Snapshot_2022-12-01_212209_budget5050 herokuapp com](https://user-images.githubusercontent.com/92704732/205131754-888015ab-48f3-4437-a079-383baa8e5683.png)
![Opera Snapshot_2022-12-01_212258_budget5050 herokuapp com](https://user-images.githubusercontent.com/92704732/205131761-09947274-5098-4418-9177-68231bcfc193.png)

## Live Demo

[Live Demo Link](https://budget5050.herokuapp.com/)

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

### Prerequisites
- Have a computer and internet connection
- Have `Ruby` installed on your computer
- Have `Rails` installed on your computer
- Have a basic knowledge of `Ruby` and `OOP` concept
- Have a basic knowledge of `Rails`
- Have a general understanding of what testing is
- Have `visual-studio code` or any other code editor installed on your computer.

### Setup
- In order to get a copy of this project you need to download it from https://github.com/ksigei/budget_app
- Extract the zipped file and open it in your code editor
### Install
- Run the command bellow in your terminal to get all required files
```
bundle install
```
```
rails assets:precompile
```

```
npm install
```
### Settup Database
- Run the command bellow in your terminal to get all required files
```
rails db:create
```
```
rails db:migrate
```
```
rails db:seed
```

### Usage
- Run the command bellow in your terminal to start the server
```
rails server
```
### Run tests
you can run one of the following command in your terminal
1. Run testing
```Ruby
rspec
```
2. Run linters
```Ruby
> npx stylelint "**/*.{css,scss}"
> Rubocop --color
> Rubocop -a
```
## Author

👤 **Kiprono Japhet**

- GitHub: [@githubhandle](https://github.com/ksigei)
- Twitter: [@twitterhandle](https://twitter.com/_kipronojaphet)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/kiprono-japhet/)

## 🤝 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

- Hats off to the whole microverse community
- To to [Gregoire Vella](https://www.behance.net/gregoirevella) whose design is used.

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