Skip to content

Latest commit

 

History

History
210 lines (140 loc) · 9.68 KB

README.md

File metadata and controls

210 lines (140 loc) · 9.68 KB

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

  • User registration and login system
  • Anonymously connect users with trained counsellors
  • Real-time messaging between users and counsellors
  • Secure and private communication using encryption
  • User-friendly interface for easy navigation
  • User profile customization options
  • Easy access to previous chat history

Technologies Used 👩‍💻

html5 css3 javascript react firebase mongodb nodejs

  • Frontend: HTML, CSS, JavaScript
  • Backend: Node.js, Express.js,Firebase
  • Database: MongoDB
  • Real-time Messaging: Socket.IO
  • Encryption: bcrypt, crypto

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