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

This project is now OFFICIALLY accepted for

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

Project Mentors✨

Aniketh Goje

Sakshi Gupta

---

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.

---

👀 Our Valuable Contributors 💖✨

Stargazers ❤️

Forkers ❤️

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		The coding period is from October 1st to October 30th, during which contributors make contributions and earn points on the platform.
Hacktoberfest 2024		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