ArthurGC / budget-app

Budget App is 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: Ruby on Rails, TailwindCSS, and Heroku.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Budget App - Ruby on Rails

Budget App is 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.

πŸ“· Screenshot

Screenshot

πŸ”΄ Live Project

πŸ”΄ Video Preview

πŸ”¨ Preview

  • Under construction

πŸ”¨ Built With

  • Ruby on Rails
  • TailwindCSS

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

First Steps

  1. Clone it using git command:
git clone https://github.com/ArthurGC/budget-app.git

Run in development (locally)

  1. Install gem files and dependencies:
bundle install
npm install or yarn install
  1. Setup you database.yml with your own postgres's password or create a PASS_POSTGRES environment variable
  password: <%= ENV["PASS_POSTGRESQL"] %>
  1. Setup db and seed file
rails db:setup
rails db:seed
  1. Run server
rails assets:precompile
rails server

If you can't see the styles for any reason try with this:

(two terminals at the same time)

Run in a terminal

bin/webpack-dev-server

Run in other terminal

rails server

Run tests

  1. To run all tests in the project
rspec

If you wanna run a certain test file

rspec spec/test_file_path

πŸ“˜ Learning Objectives

  • Use ruby gems as software packages system.
  • Install Ruby on Rails framework.
  • Understand Rails RESTful design and router.
  • Use controllers to handle requests and render empty views.
  • Use params from browser request in a safe way.
  • Use preprocessed html file with embedded Ruby code.
  • Use layouts and templates for shared content.
  • Use database migration files to maintain database schema.
  • Use validations for models.
  • Secure app from n+1 problems.
  • Understand what ORM is.
  • Write SQL queries with ActiveRecord.
  • Set up associations between models.
  • Build a webapp that requires the user to log in.
  • Use devise gem for authentication.
  • Limit access to webapp resources based on authorization rules.
  • Analyze in writing why you have made a coding choice using one structure over another.

Authors

πŸ‘€ ArthurGC

🀝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

❕ Acknowledgments

Show your support

Give a ⭐️ if you like this project!

πŸ“ License

This project is MIT licensed.

About

Budget App is 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: Ruby on Rails, TailwindCSS, and Heroku.

License:MIT License


Languages

Language:Ruby 66.8%Language:HTML 27.2%Language:JavaScript 4.3%Language:CSS 1.1%Language:SCSS 0.6%