📗 Table of Contents

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

📖 [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 With

• Ruby
• Ruby on Rails
• PostgreSQL
• RSpec

Tech Stack

Client

• Ruby on Rails
• Ruby

Server

• Render

Database

• PostgreSQL

Key Features

Describe between 1-3 key features of the application.

• [User authentication]: Users can create an account and log in.
• [Transactions]: Users can create, edit, and delete transactions.
• [Categories]: Users can create, edit, and delete categories.

(back to top)

🚀 Live Demo

• Live Demo Link

💻 Presentation link

• Presentation link

(back to top)

💻 Getting Started

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

If you dont have Ruby installed on your computer, you can download it from here.

If you dont have Rails installed on your computer, you can download it from here.

If you dont have PostgreSQL installed on your computer, you can download it from here.

Prerequisites

• Ruby: v3.1.2
• Rails: v7.0.1
• PostgreSQL: v14.5

Setup

If you have installed git you can clone the code to your machine, or download a ZIP of all the files directly.

Download the ZIP from this location, or run the following git command to clone the files to your machine:

• Once the files are on your machine, open the blog-app folder in your code editor. Run the following command in your terminal to install the required gems and run the application:

• Open the config/database.yml file in the project directory and change the username and password to your PostgreSQL username and password. Edit the default section of the file to look like this:

  default: &default
  adapter: postgresql
  encoding: unicode
  # For details on connection pooling, see Rails configuration guide
  # http://guides.rubyonrails.org/configuring.html#database-pooling
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  username: <your PostgreSQL role username>
  password: <your PostgreSQL role password>

Install

NOTE: You may need to run this command in the project directory to install the required gems and run the application:

bundle install

Usage

To run the project, execute the following command:

1. Create the database with:

rails db:create

2. Run the migrations with:

rails db:migrate

3. Start the development server with:

rails server

4. Open the app in your browser at http://localhost:3000

Run tests

To run tests, run the following command:

  bundle exec rspec

Deployment

You can deploy this project using:

1. Deplay to Heroku

  git push heroku main

2. Or deploy to Render

  git push render main

(back to top)

👥 Author

👤 Desmond Owusu Ansah

• Github @Owusu-Desmond
• Twitter @DesmondOwusuDev
• LinkedIn @desmond-owusu-ansah
• Dev.to desmondowusudev

(back to top)

🔭 Future Features

• [Add a feature to allow users to add a profile picture.]
• [Add a feature to allow users to add a cover image]
• [Add a feature to allow users to add a bio.]

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

Write a message to encourage readers to support your project

If you like this project...

(back to top)

🙏 Acknowledgments

I would like to thanks Gregoire Vella on Behance the author of the original design,

(back to top)

📝 License

This project is MIT licensed.

NOTE: we recommend using the MIT license - you can set it up quickly by using templates available on GitHub. You can also use any other license if you wish.

(back to top)