KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #open-source #agent-skills #ai #dsh-plugin #llm #windows

hiring-portal

★ 21 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](PROJECT_STRUCTURE.md)

## 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

<img src="https://www.animatedimages.org/data/media/562/animated-line-image-0184.gif" width="1920" />

## 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. ⏰

<br>

---

## Setup Instructions

To run this project locally, follow these steps:

1. **Clone the repository:**

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

2. **Navigate to the project directory:**

```bash
   cd hiring-portal
   ```

3. **Install frontend dependencies:**

```bash
   npm install
   ```

4. **Start the frontend server:**

```bash
   npm start
   ```
   Or
   ```bash
   npm run start:client
   ```

5. **Start the backend server:**

```bash
   npm run start:server
   ```

6. **Install python dependencies:**

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

7. **Start the python server:**

```bash
   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:
   ```bash
   git checkout -b feature/your-feature-name
   ```
3. **Commit your changes** with a clear message:
   ```bash
   git commit -m "Add feature/your-feature-name"
   ```
4. Push to your branch:
   ```bash
   git push origin feature/your-feature-name
   ```
5. **Open a Pull Request (PR)** 🔀and describe your changes in detail.

---

## Contact 👤

### Project Admin⚡
 
<table>
<tr>
<td align="center"><a href="https://github.com/Yashgabani845"><img src="https://avatars.githubusercontent.com/u/127788321?v=4" width=150px height=150px /></a></br> <h4 style="color:red;">Yash Niteshbhai Gabani</h4>
 <a href="https://www.linkedin.com/in/yash-gabani-527886258/"><img src="https://img.icons8.com/fluency/2x/linkedin.png" width="32px" height="32px"></img></a>
</td>
</tr>
</table>

### 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](https://opensource.org/licenses/MIT).

---

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.

---

<h3 align="center"> Happy Coding ✨🚀</h3>

---
## 📋 Participating Programs

| Name                  | Logo                                                      | Purpose                                                                                                      |
|-----------------------|-----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| GSSoC'2024-Extd       | ![GSSoC Logo](https://raw.githubusercontent.com/Yashgabani845/hiring-portal/main/assets/GSSoC-Ext.png)             | 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](https://raw.githubusercontent.com/Yashgabani845/hiring-portal/main/assets/hacktoberfest.png) | Hacktoberfest is a month-long October event welcoming all skill levels to join the open-source community.     |

---

## 📊 Project Metrics

<table align="center">
    <thead align="center">
        <tr>
            <td><b>🌟 Stars</b></td>
            <td><b>🍴 Forks</b></td>
            <td><b>🐛 Issues</b></td>
            <td><b>🔔 Open PRs</b></td>
            <td><b>🔕 Closed PRs</b></td>
        </tr>
     </thead>
    <tbody>
         <tr>
            <td><img alt="Stars" src="https://img.shields.io/github/stars/Yashgabani845/hiring-portal?style=flat&logo=github"/></td>
            <td><img alt="Forks" src="https://img.shields.io/github/forks/Yashgabani845/hiring-portal?style=flat&logo=github"/></td>
            <td><img alt="Issues" src="https://img.shields.io/github/issues/Yashgabani845/hiring-portal?style=flat&logo=github"/></td>
            <td><img alt="Open Pull Requests" src="https://img.shields.io/github/issues-pr/Yashgabani845/hiring-portal?style=flat&logo=github"/></td>
            <td><img alt="Closed Pull Requests" src="https://img.shields.io/github/issues-pr-closed/Yashgabani845/hiring-portal?style=flat&color=green&logo=github"/></td>
        </tr>
    </tbody>
</table>

hiring-portal

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README