Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kdlamini/budget-app
A mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.
https://github.com/kdlamini/budget-app
rails ruby
Last synced: 23 days ago
JSON representation
A mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.
- Host: GitHub
- URL: https://github.com/kdlamini/budget-app
- Owner: KDlamini
- Created: 2022-03-15T11:53:06.000Z (almost 3 years ago)
- Default Branch: dev
- Last Pushed: 2022-04-24T11:51:22.000Z (over 2 years ago)
- Last Synced: 2023-03-08T17:08:13.976Z (almost 2 years ago)
- Topics: rails, ruby
- Language: Ruby
- Homepage: https://young-falls-16975.herokuapp.com/
- Size: 177 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
#### Original design idea by **[Gregoire Vella on Behance](https://www.behance.net/gregoirevella)**, in association with the [Creative Commons license of the design](https://creativecommons.org/licenses/by-nc/4.0/) of the design.
# GoSave
A mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.
## Built With
- Ruby on Rails
## Live Demo
[Heroku](https://young-falls-16975.herokuapp.com/)
## Additional Tools
- rubocop
- stylelint
- Ruby Gems
## Versions
- Ruby ~3.1.0
- PostgreSQL ~12.9
- Node.js ~14.17.6
- Yarn ~1.22.17
## `Getting Started`
To get a local copy of this project:
Clone this repository or download the Zip folder:
```
$ git clone [email protected]:KDlamini/Budget-app.git
```
Then:
```
$ cd Budget-app
$ gem install bundler
$ bundle install
```
To start App:
```
$ rails server
```
To view on browser:
```
http://localhost:3000
```
## `Database creation`
Create a Postgres user:
```
$ su - postgres
```
After that access Postgres:
```
psql
```
Then create a user (or a “role”, as Postgres calls it):
```
CREATE ROLE budget WITH CREATEDB LOGIN PASSWORD 'budget';
```
Initialize the database:
```
$ bin/rails db:setup
```
Migrate the database:
```
$ bin/rails db:create
```
## `Tests`
### Running specs:
Default: Run all spec files (i.e., those matching spec/**/*_spec.rb):
```
$ bundle exec rspec
```
Run all spec files in a single directory (recursively):
```
$ bundle exec rspec spec/models
```
Run a single spec file:
```
$ bundle exec rspec spec/models/user_spec.rb
```
Run a single example from a spec file (by line number):
```
$ bundle exec rspec spec/models/user_spec.rb:8
```
See all options for running specs:
```
$ bundle exec rspec --help
```
### rails tests:
```
$ bin/rails test
```
### To track linter errors locally follow these steps:
Track Ruby linter errors run:
```
$ rubocop
```
To auto-correct correctable Rubocop offenses run:
```
$ rubocop --auto-correct-all | rubocop -A
```
## `Authors`
👤 **Simo Nkosi**
- GitHub: [@KDlamini](https://github.com/KDlamini)
- Twitter: [@RealSimoNkosi](https://twitter.com/RealSimoNkosi)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/simo-nkosi-418523180/)
## 🤝 Contributing
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](https://github.com/KDlamini/Budget-app/issues).
## Show your support
Give a ⭐️ if you like this project!
## Acknowledgments
- This project is part module 5 in the Microverse study program.
- Thanks to the Microverse team for the great curriculum.
- Thanks to Code Reviewers for the insightful feedback.
- A great thanks to My coding partners, morning session team, and standup team Partners for their contributions.
## 📝 License
This project is [MIT](./MIT.md) licensed.