Skip to content

A Roommates expenses app. Uses an API REST on a node server.

License

Notifications You must be signed in to change notification settings

jfoyarzo/RoommatesApp

Repository files navigation

📗 Table of Contents

📖 Roommates App

Roommates App is a Node.js app that consists of an API RESTful that can GET, POST, UPDATE and DELETE roommates expenses. The server is built using the http module and file manipulation is made by fs. It also has the functionality to send emails to all the roommates each time a new expense is registered. The frontend is rendered dynamically by the server and is built using Bootstrap 4.5.

🛠 Built With

Tech Stack

Backend/Frontend

Key Features

  • CRUD functionality for roommates expenses.
  • Node Mailer used to send email notification to users when new expense is registered.
  • JSON format is used for the API data.

(back to top)

🚀 Live Demo

  • Coming soon...

(back to top)

💻 Getting Started

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

Prerequisites

To run this project you need:

  • Node.js

Setup

Clone this repository to your desired folder:

git clone git@github.com:jfoyarzo/RoommatesApp.git

Install

Install this project's dependencies with:

npm install

Usage

To start the server use the following command:

node index.js

This will serve the frontend on:
http://localhost:3000
For the mailing functionality to work, valid credentials must be provided in the mailer.js file.

(back to top)

👥 Authors

👤 Felipe Oyarzo

(back to top)

🔭 Future Features

  • Full calculations functionality
  • Better and responsive design
  • Option to opt-out from email notifications

(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 give it a ⭐!

(back to top)

📝 License

This project is MIT licensed.

(back to top)

About

A Roommates expenses app. Uses an API REST on a node server.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published