Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adarshaacharya/mentorlabs
Learn, collab and grow together to the moon. :rocket:
https://github.com/adarshaacharya/mentorlabs
express hacktoberfest hacktoberfest-accepted hacktoberfest2021 mentorlabs nodejs postgres postgresql reactjs redux-toolkit socket-io typeorm typescript webrtc
Last synced: about 3 hours ago
JSON representation
Learn, collab and grow together to the moon. :rocket:
- Host: GitHub
- URL: https://github.com/adarshaacharya/mentorlabs
- Owner: adarshaacharya
- License: mit
- Created: 2021-06-02T12:57:12.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-04T18:12:11.000Z (about 2 years ago)
- Last Synced: 2023-03-03T01:25:12.018Z (over 1 year ago)
- Topics: express, hacktoberfest, hacktoberfest-accepted, hacktoberfest2021, mentorlabs, nodejs, postgres, postgresql, reactjs, redux-toolkit, socket-io, typeorm, typescript, webrtc
- Language: TypeScript
- Homepage: https://mentorlabs.herokuapp.com/
- Size: 7.74 MB
- Stars: 41
- Watchers: 1
- Forks: 13
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Learn, Collab & Grow Together.
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](https://mentorlabs.herokuapp.com). 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](https://github.com/adarshaacharya/MentorLabs/issues/new/choose) 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](https://www.beekeeperstudio.io/) as database toolkit for easy database setup. (Optional)
#### Step 1: Clone the repo
```sh
https://github.com/adarshaacharya/MentorLabs.git
```
#### Step 2 : Install dependencies
cd into the directory
```sh
cd MentorLabs
```
In the root folder do:
```sh
# first install server deps
yarn
# also install client deps
cd client && yarn
```
#### Step 3 : Configuration
1. Create `.env` file in the root directory.
```sh
touch .env
```
2. Open [.env.example](./.env.example) file, copy everything
3. Paste the content in `.env` file
4. Create database named `mentor-labs` with [Beekeeper Studio](https://www.beekeeperstudio.io/) or `postgres-cli` from your terminal. _(You don't have to create tables for database)_
```sql
CREATE TABLE "mentor-labs";
```
5. Again open `.env` file and replace fields like `DB_USER`, `DB_PASS` with your own credentials.
6. Create account on [Twilio](https://twilio.com/) and open the [Twilio dashboard](https://console.twilio.com/?frameUrl=/console).
7. Copy `TWILIO_ACCOUNT_SID` and `TWILIO_AUTH_TOKEN` keys and paste it on `.env` file on their respective fields.
8. For client too, we have small issue (might be fixed on near future). Go to `client` folder and create `.env` file.
```sh
cd client && touch .env
```
9. Copy everything of [.env.example](./client/.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](github.com/adarshaacharya/MentorLabs/issues). We will try to work on that._
#### Step 4: Usage
Now, you can run application by
```sh
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](https://github.com/adarshaacharya/MentorLabs/blob/master/CONTRIBUTING.md) for complete contributing guidelines.
## Contributors
- WIP
## License
Copyright © 2021 [Aadarsha Acharya](https://adarshaacharya.com.np).
This project is MIT licensed.