UseItWisely

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

Additional Tools

• rubocop
• stylelint
• Ruby Gems

Versions

• Ruby ~3.1.0
• PostgreSQL ~12.9
• Node.js ~14.17.6

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

👤 Have Samuel

• GitHub: Have-Samuel
• Twitter: @samhave1
• LinkedIn: Have Samuel Kabreebe

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

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.

Original design idea by Gregoire Vella on Behance, in association with the Creative Commons license of the design of the design.

📝 License

This project is MIT licensed.