CareerMarg - Job Portal

CareerMarg is a feature-packed job portal built on the MERN stack, providing role-based dashboards and functionalities for jobseekers, recruiters, and administrators. It simplifies the hiring process with advanced job search, CV generation, recruiter management, and powerful admin tools.

Navigation

• Tech Stack
• Roles and Features
• Key Features
• Installation and Setup
• Demo Pages
• Usage
• Acknowledgements

Tech Stack

• Frontend: React (Vite), TanStack, Tailwind CSS
• Backend: Node.js, Express.js
• Database: MongoDB
• State Management: TanStack Query
• File Uploads: Multer (images & CVs)
• Charts & Graphs: Recharts

Roles & Features

Jobseeker

• Register and log in as a jobseeker
• Search for jobs with advanced filters (category, location, etc.)
• Apply to jobs directly
• Generate CV in-app and download it
• Upload CVs (PDF only)
• Apply to become a recruiter

Recruiter

• Post new jobs with full details
• Publish / Unpublish jobs
• View applicants for each job
• See open to work candidates based on location
• Manage applications for their posted jobs

Admin

• Access to admin dashboard
• Add and manage job categories
• Manage all users (jobseekers & recruiters)
• Approve or Reject jobseekers' request for becoming recruiter
• View metrics and analytics via charts & graphs
• Full control over platform data and activities

Visitors

• Public homepage for users without accounts
• Can view jobs with limited details
• Option to sign up as a jobseeker

Key Features

• Role-Based Routing → Each role is redirected to its own dashboard
• Job Search & Filtering → Easy navigation for jobseekers
• Recruiter Management → Powerful tools for recruiters
• Admin Dashboard → Analytics, user management, and job category control
• File Uploads with Validation → Images restricted to image formats, CVs restricted to PDF only
• Responsive Design → Optimized for desktop and mobile devices

Installation & Setup

1. Clone the repository

   git clone https://github.com/aryanad/react-job.git
   cd react-job

2. Install dependencies

   # Install extra dependencies
   npm i --legacy-peer-deps
   
   # Install server dependencies
   cd backend
   npm i --legacy-peer-deps
   
   # Install client dependencies
   cd ..
   cd frontend
   npm i --legacy-peer-deps

3. Set up environment variables and file uploads

• Create .env file in server directory following the template below:

  MONGO_URI = <your_mongodb_string>
  JWT_SECRET = <randomStringForJWT>
  PORT=9000
  

• Create an uploads directory in the root directory

4. Run the development server from the root directory

   # Start Server
   npm run dev

5. Open your browser
   Visit: http://localhost:5173

Demo Pages

Login Page Visitor Homepage Jobseeker Profile Applyable Jobs Eligible Jobseekers Job Details Job Applicants & Notifications Admin Dashboard User Management

Usage

• Jobseekers → Sign up, search, filter, apply for jobs, and generate/download CVs
• Recruiters → Post jobs, view/manage applications, upload images, and publish/unpublish listings
• Admin → Control job categories, users, and monitor analytics with charts

Acknowledgements

• React
• Vite
• Tailwind CSS
• TanStack Query
• Express.js
• MongoDB
• Multer

---

🚀 CareerMarg empowers jobseekers, recruiters, and admins with a seamless hiring experience.