/-Budget-app

Primary LanguageRuby

Budget App

A classic budget app to keep track of your expenses by category, made with Rails, Turbo's Stimulus. It includes full user authentication and authorization. It also has fully tested functionality with unit tests and integration tests. Built within a week's work.

live server

Check out the free Heroku demo

Built With

  • Ruby on Rails
  • PostgreSQL
  • devise & cancancan
  • rspec/rails & capybara
  • bullet
  • turbo & stimulus

Getting Started

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

Prerequisites

  • Ruby ruby-3.1.2 installed
  • PostgreSQL dbms running

Setup Project

  • Open your terminal and navigate to the folder you would like to save the project.

  • Type these commands into the terminal:

git clone https://github.com/ABDULALI3468/Budget-app.git
cd budget-app
bundle install
  • You will need a .env file before you install and run the project. The .env file contains environment variables needed to deploy the webpage. There is a commented .env.example file you can use as a guide to configure your own. Type the following command into the terminal (or Git Bash, if using Windows) to create your .env file:
cp .env.example .env
rails secret

  • Edit file .env

    • Replace the value for the variable DEVISE_JWT_SECRET_KEY with the value returned by the rails secret command.
    • Provide values for DATABASE_HOST, DATABASE_USER and DATABASE_PASSWORD

  • Type this command into the terminal to reset the database:

rails db:reset

Run application

  • Type this commands into the terminal:
rails server

Run tests

  • Type these commands into the terminal
rspec spec -f doc lib

Author

👤 Abdelrahman Mohamed

  • This is My GitHub: GitHub followers
  • This is My Linkedin: [Linkedin Badge

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

Template

Full thank you to Gregoire Vella on Behance for the awesome Snapscan - iOs design and branding template! :)