• 📖 About the Project
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 Live Demo
• 💻 Getting Started
  • Setup
  • Prerequisites
  • Install
  • Usage
  • Run tests
  • Deployment
• 👥 Authors
• 🔭 Future Features
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• ❓ FAQ
• 📝 License

This 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. [MY BUDGET] is a mobile application coding with Ruby on Rails!

• **Custom categories for each user
• **Transactions are displayed to show the balance of money
• **Display their expenditure on each category

(back to top)

live

video

(back to top)

ruby --version && irb

The ouput should start with something like ruby 3.1.2

If not, install the right ruby version using rbenv (it could take a while):

rbenv install 3.1.2

To get a local copy up and running, follow these steps.

git clone https://github.com/tamana-Balkhi/BudgetApp.git
cd blog-app-ror

• Ensure you have PostgreSQL installed before running the application psql --version
• Run bundle install
• Create a .env file in the project's root folder to assign variable values for the psql database (linked to the config/database.yml)
• Run rails db:create and then rails db:migrate
• Run rails server
• Open Browser http://localhost:3000/

This is the intended file content for the .env file:

# ./env
POSTGRES_HOST='localhost'
POSTGRES_USER='postgres'
# If you declared a password when creating the database:
POSTGRES_PASSWORD='a'

# POSTGRES_HOST='localhost'
# dbs
POSTGRES_DEV_DB='my_budget'
POSTGRES_TEST_DB='my_budget_test'
POSTGRES_PROD_DB='my_budget_prod'
# PROD_PASSWORD = 'production_password'
# 

Replacing the variable values where needed (most importantly `username` and `password`)

### Usage

To run the project, execute the following command:

```sh
  rails server

To test and utilize the code, use the terminal and run ruby by inputting irb in the command line, or by using an extension in Visual Studio Code like Code runner

The user then can modify and play with the files as needed

(back to top)

👤 Tamana Balkhi

• GitHub: @tamana-Balkhi
• LinkedIn: Tamana Balkhi

(back to top)

• Validations and Model specs
• Setup and controllers
• Views and Forms

(back to top)

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

Give a ⭐️ if you like this project!

(back to top)

Original design idea by Gregoire Vella on Behance

(back to top)

This project is MIT licensed.

(back to top)