Counselllor / Counsellor-Web

Counselling/Recommendation System for new Undergrad Students
http://counsellor.social/
MIT License
77 stars 174 forks source link

Counsellor 👨‍🏫

The web application, built using ReactJS, is designed to assist students in making informed decisions regarding their undergraduate studies. It provides a platform for students to explore and choose the right stream/branch that aligns with their interests and career aspirations. Additionally, the app leverages real and honest insights from current college students to help students choose the right and convenient college based on their specific needs and preferences. This app serves as a valuable resource for students looking to make the most of their undergraduate education and embark on a successful career path.



Table of Contents

Features


Technologies Used 👩‍💻

html5 css3 javascript react firebase mongodb nodejs


Installation

With Docker

  1. Clone this repository to your local machine using:

    git clone https://github.com/thestarsahil/Counsellor.git
  2. Navigate to the project directory:

    cd Counsellor
  3. Build the docker image

    docker build -t counsellor-web .
  4. Run the docker image

    docker run -p 5173:5173 counsellor-web

Without Docker

To run Counsellor locally, follow these steps:

  1. Clone this repository to your local machine using:

    git clone https://github.com/thestarsahil/Counsellor.git
  2. Navigate to the project directory:

    cd Counsellor
  3. Install the required dependencies using npm:

    npm install
  4. Configure Firebase: Create an account on firebase https://console.firebase.google.com/ and craete a project in it.

  5. Create .env file and add all the firebase environment variables listed in .env.example file with valid values.

  6. Start the server:

    npm run dev
  7. Open your web browser and visit http://localhost:5173 to access the Counsellor application.


Usage

Once the application is running, users can register or log in to their accounts. After logging in, they can choose to start a chat with a counsellor. The chat interface allows real-time messaging between the user and the assigned counsellor. Users can customize their profile and view their chat history.


Demo -> Live site

8 9 10 11

5 13

6 15

7 17

18 19

20 21


Contributing 🎉

Contributions to Counsellor are welcome! If you find any issues or have suggestions for improvements, please feel free to submit a pull request or open an issue on the GitHub repository.

Before contributing, please review the Contributing Guidelines.


License 🪪

This project is licensed under the MIT License. See the LICENSE file for more information.


Connect with us 🖇️

Discord

Slack


Contact 📞

Contributing

For any inquiries or questions regarding Counsellor, please contact the project owner: Sahil Ali .

thestarsahil

Thank you for your interest in Counsellor! We hope it can provide valuable support to those in need.

Contributors