Skip to content

Latest commit

 

History

History
234 lines (162 loc) · 7.73 KB

README.md

File metadata and controls

234 lines (162 loc) · 7.73 KB
Raw

HireHub 🚀

HireHub is a comprehensive hiring portal built using the MERN stack (MongoDB, Express.js, React, Node.js). It provides a platform for job seekers to browse and apply for jobs, employers to manage job postings and candidate shortlisting, and admins to oversee the platform's operations.

Project Structure ✨

Check the project structure here Project Structure

Technologies Used 🛠️

  • Frontend: React, Redux

  • Backend: Node.js, Express.js, Python

  • Storage: Firebase-Clous

  • Database: MongoDB

  • Authentication: JWT (JSON Web Tokens)

  • Styling: CSS, Bootstrap, Material UI

Features 🌟

For Job Seekers:

  • Apply for Jobs: Browse job listings and apply directly.📄
  • Receive Email Notifications: Get automatic email notifications on application status. 📧
  • Coding Assessments: Complete integrated coding tests within the platform, with built-in code compilation and instant feedback. 💻
  • Secure Link Management: Ensures data integrity and protection for coding assessments. 🔒

For Employers:

  • Company Registration: Register your company and manage your profile.
  • Manage Job Postings: Create, edit, and manage job listings through a user-friendly dashboard.
  • Create Coding Assessments: Set up coding tests for candidates and define evaluation criteria.
  • Assessment Results: Review detailed reports of coding tests and manage results effectively.

Upcoming Features:

  • Interview Scheduling: Real-time video interviews using WebRTC. 🎥

  • Advanced Search Filters: Filter jobs by location, experience, and more.🔍

  • Real-time Notifications: Get updates for job applications, interviews, etc. ⏰


Setup Instructions

To run this project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/Yashgabani845/hiring-portal.git

  2. Navigate to the project directory:

    cd hiring-portal

  3. Install frontend dependencies:

    npm install

  4. Start the frontend server:

    npm start

    Or

    npm run start:client

  5. Start the backend server:

    npm run start:server

  6. Install python dependencies:

    pip install Flask Flask-CORS PyPDF2 google-generativeai python-dotenv

  7. Start the python server:

    python ats.py

Directory Structure 📂

Here is an overview of the project's directory structure:

/hiring-portal
├── Backend               🔧 Server-side logic and APIs
│   ├── controllers       📂 Request handlers and business logic
│   ├── models            🗄️  Database schemas and models
│   ├── routes            🚦 API route definitions
│   └── temp              🗃️  Temporary files (logs or drafts)
├── public                🌐 Static files for frontend (index.html, etc.)
└── src                   🛠️  Frontend application source code
    ├── CSS               🎨 Styling and CSS files
    ├── Components        📦 Reusable React components
    ├── assets            🖼️  Static resources like images and icons
    ├── firebase          🔥 Firebase configuration and integrations

Contribution Guidelines 🤝🌟

We welcome contributions from the community! To contribute, please follow these guidelines:

  1. Fork the repository and clone it locally.
  2. Create a new branch for your feature or bug fix: 
    git checkout -b feature/your-feature-name
  3. Commit your changes with a clear message: 
    git commit -m "Add feature/your-feature-name"
  4. Push to your branch: 
    git push origin feature/your-feature-name
  5. Open a Pull Request (PR) 🔀and describe your changes in detail.

Contact 👤

Project Admin⚡


Yash Niteshbhai Gabani

Issue Reporting 🐛✨

If you encounter any bugs or have feature requests, please follow this format when opening an issue:

  • Issue Title: 📝 A concise and descriptive title.
  • Description: 🔍 Clear and detailed description of the issue or feature request.
  • Steps to Reproduce (if applicable): 🚶Detailed steps to reproduce the issue.
  • Expected Behavior: ✅What you expected to happen.
  • Actual Behavior: ❌What actually happened.

License 📃

This project is open source and available under the MIT License.

Feel free to contribute, suggest features, or report issues to improve HireHub!

💬 Feedback & Support 📬

If you have any feedback, questions, or issues, feel free to reach out or open a GitHub Issue. -Linkedin:- https://www.linkedin.com/in/yash-gabani-527886258/ -Github:- https://github.com/Yashgabani845

Feel free to contact us at any of our social media handles incase of issue.

Happy Coding ✨🚀

📋 Participating Programs

Name Logo Purpose
GSSoC'2024-Extd GSSoC Logo The coding period is from October 1st to October 30th, during which contributors make contributions and earn points on the platform.
Hacktoberfest 2024 Hacktoberfest Logo Hacktoberfest is a month-long October event welcoming all skill levels to join the open-source community.

📊 Project Metrics

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Closed PRs
Stars Forks Issues Open Pull Requests Closed Pull Requests