Skip to content

adarshaacharya/MentorLabs

Repository files navigation

logo

Learn, Collab & Grow Together.

github actions License: MIT

View Demo · Report Bug · Request Feature

MentorLabs is a a WebRTC based video conferencing app. Apply for mentorship to the top mentors recommended by our powerful algorithm based on your profile. Enjoy one-to-one live mentorship in our interactive video streaming labs for free.

⚠️ This is pre-released (experimental) version of Mentor Labs website. That means we are still working to improve the site and breaking changes may occur anytime. So please avoid providing your real profile details as the app isn't fully secure and data may get erased any time. Meanwhile, you can help us by raising an issue if you find any bugs in the project.

Features

  • Authentication and Authorization
  • Personal Dashboard for Mentor and Mentee
  • Recommendation System
  • Apply and Respond Mentorship Request
  • Create and join private room
  • Video and text based chat
  • Screen sharing

Tech Stack

  • Frontend : Typescript, React.js, Redux Toolkit
  • Styling : Ant Design, Custom Css with BEM naming convention
  • Backend : Typescript, Node.js, Express.js
  • Database : TypeORM with PostgreSQL database
  • Tesing : Jest, React Testing Library
  • Realtime Communication : simple-peer (WebRTC), Socket.io
  • Algorithms : Jaccard Similarity, Supervised recommendation algorithm, QuickSort Hoare
  • Deployment : Server, Client and Database hosted on Heroku

Local Development

Before running app locally make sure that you've install flowiing things in your machine:

  • Node.js version v14.18.1 (if you are using nvm try nvm use 14.18.1 ) and yarn version v1.22.17
  • PostgreSQL >= v12.8
  • Download and install Beekeeperstudio as database toolkit for easy database setup. (Optional)

Step 1: Clone the repo

https://github.com/adarshaacharya/MentorLabs.git

Step 2 : Install dependencies

cd into the directory

 cd MentorLabs

In the root folder do:

  # first install server deps
  yarn

  # also install client deps
  cd client && yarn

Step 3 : Configuration

  1. Create .env file in the root directory.
  touch .env
  1. Open .env.example file, copy everything

  2. Paste the content in .env file

  3. Create database named mentor-labs with Beekeeper Studio or postgres-cli from your terminal. (You don't have to create tables for database)

  CREATE TABLE "mentor-labs";
  1. Again open .env file and replace fields like DB_USER, DB_PASS with your own credentials.

  2. Create account on Twilio and open the Twilio dashboard.

  3. Copy TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN keys and paste it on .env file on their respective fields.

  4. For client too, we have small issue (might be fixed on near future). Go to client folder and create .env file.

  cd client  && touch .env
  1. Copy everything of .env.example located inside client directory and paste it inside .env file of client directory. (You ca leave REACT_APP_SENTRY_DSN field empty)

The configuration is quite hard tbh, if you encounter any problems in setup you can directy create issue. We will try to work on that.

Step 4: Usage

Now, you can run application by

yarn dev

# Server runs on http://localhost:5000 and client on http://localhost:3000

Production Deployment

There is a Heroku post build script so that you do not have to compile your React frontend manually, it is done on the server. Simply push to Heroku and it will build and load the client index.html page

Contributing

Contributions, issues and feature requests are welcome. After cloning & setting up project locally, you can just submit a PR to this repo and it will be deployed once it's accepted. Read CONTRIBUTING.md for complete contributing guidelines.

Contributors

  • WIP

License

Copyright © 2021 Aadarsha Acharya. This project is MIT licensed.