Skip to content

Latest commit

 

History

History
202 lines (129 loc) · 4.7 KB

README.md

File metadata and controls

202 lines (129 loc) · 4.7 KB

📗 Table of Contents

📖 Budget Pal (rails app)

Budget Pal is a web app for keeping track of payments, where users can register, create categories, and add payments to one or more category. It also displays the total amount spent on each category. Ruby on Rails was used for the backend/frontend of the app and bulma-css for styles. Also uses the devise gem for authentication

🛠 Built With

Tech Stack

Client/Server
Database

Key Features

  • Data is processed in models
  • Users can register
  • Users can add categories
  • Users can add payments

(back to top)

🚀 Live Demo


Live Demo on Render

(back to top)

💻 Getting Started

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

Prerequisites

In order to run this project you need: ruby version 2.7.0+
rails version 7+
PostgreSQL
Yarn
Npm

Setup

Clone this repository to your desired folder using this command:

git clone git@github.com:jfoyarzo/budget-app.git
cd budget-app

Install

Install this project's dependencies using:

bundle install
yarn install
npm install

Usage

This app uses postgreSQL databases for data preservation. Please provide valid credentials in a .env file and place it in the root folder.

To initialize database run:

rails db:create
rails db:schema:load

To run the server, execute the following command from the root folder of the app:

./bin/dev

You can also use

rails server

this will start the server on http://localhost:3000/

To use the features of the app, you'll have to sign up using:

http://127.0.0.1:3000/users/sign_up

Once you sign up, you can log in from:

http://127.0.0.1:3000/users/sign_in

Run tests

To run tests, run the following command:

rspec

Deployment

You can deploy this project using:

TBA

(back to top)

👥 Author

👤 Felipe Oyarzo

(back to top)

🔭 Future Features

  • Improved user interface
  • Complete CRUD funcionality
  • Historical data and metrics

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project please consider giving it a star!

(back to top)

🙏 Acknowledgments

Original design idea by Gregoire Vella on Behance.
I would like to thank Microverse for the opportunity.

(back to top)

📝 License

This project is MIT licensed.

(back to top)