GAFelton / thanksgiving-together

A Thanksgiving Companion App which allows families to share this holiday no matter the distance.
MIT License
1 stars 2 forks source link

Thanksgiving Together

GitHubTravis CI

Description:

There are so many ways in which we've had to adjust our lives in response to the COVID-19 pandemic. One of the major changes for many is that we are missing out on in-person family time that we would otherwise during major holidays. We built this app to solve a need for people who want to celebrate Thanksgiving with family, but who don't want the same videochat experience they've already had too much of from work and school.

Thanksgiving Together allows families to sign up together for a group experience that augments their Zoom call. It includes features like a recipe tracker, games, a "Discussion Topic" button & more.

The app is built on the MERN stack, uses react-bootstrap as a CSS framework, and integrates with the Zoom SDK and the Edamam API. The Zoom call handling is implemented on a second server (Link to GitHub Repo).

This project was initially built in Nov. 2020 over 20 days by 5 people. Our goal is to help families share this holiday no matter the distance.

Link to the GitHub Repo

Recipes-Screenshot

Table of Contents

  1. Fork the repo.

  2. Clone the repo to your local machine.

  3. On your local repo, run npm install for npm packages from both .

  4. Create a MongoDB database called thanksgivingtogetherdb, and make sure mongod.exe is running whenever you want to test the app locally.

  5. Create a file titled .env in the root folder. Inside it, you will include your secret key for creating JSON web tokens. For the best security, this should be a randomly generated alphanumeric string of length 64. Format for .env file:

    SECRET={your-secret-here}
  6. Run npm start to start your node server, and visit localhost:3000 to interact with Thanksgiving Together.

    Usage

Create a user account and a new family or join an existing one. Once you are logged in, the family admin should add Zoom room details via the user settings button and start a Zoom call from the Zoom desktop client (or Zoom's website). The rest of the family can join the call from the Thanksgiving Together app!

Discussion Topic Button

License

MIT

Contribution Guidelines

Reach out if you'd like to collaborate. Raising an issue, or Pull Requests are welcome!

Tests

Run npm test for an ESLint test.

Contributors

Name
Byoung23
GAFelton
iveylee
mavn2
xelinx

Questions

Please address questions to GAFelton. (E-mail)