Skip to content

Yashgabani845/hiring-portal

Repository files navigation

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.

Technologies Used 🛠️

  • Frontend: React, Redux

  • Backend: Node.js, Express.js

  • 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
  5. Open a new terminal and navigate to the backend directory:

    cd backend
  6. Start the backend server:

    node server.js

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.

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 💖✨


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 ✨🚀