JobHunt - Job Portal

A MERN stack job portal connecting job seekers with employers through job browsing, applications, and postings.

� About

JobHunt is a comprehensive job portal platform that streamlines the hiring process. It serves as a bridge between talented job seekers and companies looking to hire. The platform enables:

• Job Seekers to discover opportunities, build profiles, and manage job applications
• Companies to post job openings, track applicants, and manage the hiring workflow
• Admins to oversee platform operations and manage all stakeholders

Built with modern web technologies, JobHunt provides a seamless user experience with real-time updates, file uploads for resumes and company logos, and a responsive design that works across all devices.

�📋 Table of Contents

• Features
• Tech Stack
• Project Structure
• Backend Setup
• Frontend Setup
• Running the Application
• API Endpoints
• User Types
• Contributing
• Author

✨ Features

User Features

• User Authentication: Secure sign up and login with JWT authentication
• Profile Management: Update user profile with profile picture, bio, and resume
• Job Browsing: Browse and filter jobs by category, location, and experience level
• Job Search: Search for jobs using keywords
• Job Applications: Apply for jobs and track application status
• Application History: View all applied jobs and their current status

Company Features

• Company Registration: Create and manage company accounts
• Job Posting: Post new job openings with detailed descriptions
• Application Management: View and manage all job applications
• Applicant Tracking: Track applicants and update application status

Admin Features

• Company Management: Manage all companies on the platform
• Job Oversight: Monitor job postings and applications

🛠 Tech Stack

Backend

• Node.js - JavaScript runtime
• Express.js - Web framework
• MongoDB - NoSQL database
• Mongoose - MongoDB object modeling
• JWT - JSON Web Tokens for authentication
• Bcryptjs - Password hashing
• Cloudinary - Image hosting and management
• Multer - File upload middleware
• CORS - Cross-origin resource sharing
• Nodemon - Development server auto-reload

Frontend

• React 19 - UI library
• Vite - Build tool and development server
• Redux Toolkit - State management
• React Router - Client-side routing
• Tailwind CSS - Utility-first CSS framework
• Shadcn/UI - Component library
• Axios - HTTP client
• React Icons - Icon library
• Sonner - Toast notifications

📁 Project Structure

JobHunt---JobPortal/
├── backend/
│   ├── config/
│   │   ├── cloudinary.js      # Cloudinary configuration
│   │   ├── dataUri.js         # Data URI utility for image handling
│   │   └── db.js              # MongoDB connection
│   ├── controllers/
│   │   ├── authController.js        # Authentication logic
│   │   ├── userControllers.js       # User operations
│   │   ├── companyController.js     # Company operations
│   │   ├── jobControllers.js        # Job operations
│   │   └── applicationControllers.js # Application handling
│   ├── middlewares/
│   │   ├── isAuth.middleware.js     # JWT verification
│   │   └── multer.js                # File upload setup
│   ├── models/
│   │   ├── userModels.js        # User schema
│   │   ├── companyModels.js     # Company schema
│   │   ├── jobModels.js         # Job schema
│   │   └── applicationModels.js # Application schema
│   ├── routes/
│   │   ├── authRoutes.js           # Auth endpoints
│   │   ├── companyRoutes.js        # Company endpoints
│   │   ├── jobRoutes.js            # Job endpoints
│   │   └── applicationRoutes.js    # Application endpoints
│   ├── index.js        # Server entry point
│   └── package.json    # Backend dependencies
│
├── frontend/
│   ├── public/         # Static assets
│   ├── src/
│   │   ├── components/
│   │   │   ├── Admin/              # Admin components
│   │   │   ├── auth/               # Authentication components
│   │   │   ├── shared/             # Shared components (Navbar, etc.)
│   │   │   ├── ui/                 # UI components (buttons, dialogs, etc.)
│   │   │   ├── hooks/              # Custom React hooks
│   │   │   ├── Home.jsx            # Home page
│   │   │   ├── Browse.jsx          # Job browsing page
│   │   │   ├── Jobs.jsx            # Jobs listing
│   │   │   ├── JobDetails.jsx      # Job details page
│   │   │   ├── AppliedJobs.jsx     # User's applied jobs
│   │   │   ├── Profile.jsx         # User profile
│   │   │   └── Footer.jsx          # Footer component
│   │   ├── redux/
│   │   │   ├── authSlice.js        # Auth state management
│   │   │   ├── companySlice.js     # Company state management
│   │   │   ├── jobSlice.js         # Job state management
│   │   │   └── store.js            # Redux store configuration
│   │   ├── lib/
│   │   │   └── utils.js            # Utility functions
│   │   ├── utilis/
│   │   │   └── constants.js        # Application constants
│   │   ├── App.jsx                 # Main App component
│   │   ├── main.jsx                # React entry point
│   │   ├── index.css               # Global styles
│   │   └── App.css                 # App styles
│   ├── vite.config.js      # Vite configuration
│   ├── eslint.config.js    # ESLint configuration
│   ├── components.json     # Shadcn component configuration
│   ├── package.json        # Frontend dependencies
│   └── index.html          # HTML template
│
└── README.md (this file)

🛠️ Backend Setup

Prerequisites

• Node.js (v14 or higher)
• MongoDB Atlas account or local MongoDB
• Cloudinary account (for image uploads)

Installation

1. Navigate to the backend directory:

cd backend

2. Install dependencies:

npm install

3. Create a .env file in the backend directory:

MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key
CLOUDINARY_NAME=your_cloudinary_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
PORT=8000

4. Start the backend development server:

npm run dev

The backend server will run on http://localhost:8000

🚀 Frontend Setup

Prerequisites

• Node.js (v14 or higher)
• npm or yarn

Installation

1. Navigate to the frontend directory:

cd frontend

2. Install dependencies:

npm install

3. The frontend is configured to connect to http://localhost:8000 for API calls.

4. Start the frontend development server:

npm run dev

The frontend will run on http://localhost:5173

Build for Production

npm run build

This creates an optimized production build in the dist folder.

🎯 Running the Application

Start Both Backend and Frontend

You'll need two terminal windows:

Terminal 1 - Backend:

cd backend
npm run dev

Terminal 2 - Frontend:

cd frontend
npm run dev

Then open your browser and navigate to http://localhost:5173

📡 API Endpoints

Authentication Routes (/api/v1/user)

• POST /register - Register a new user
• POST /login - User login
• GET /logout - User logout
• GET /profile - Get user profile (requires authentication)
• PUT /profile/update - Update user profile (requires authentication)

Job Routes (/api/v1/jobs)

• GET / - Get all jobs
• GET /:id - Get job by ID
• POST /create - Create a new job (requires authentication)
• PUT /:id - Update a job (requires authentication)
• DELETE /:id - Delete a job (requires authentication)

Company Routes (/api/v1/company)

• POST /register - Register a new company
• GET / - Get all companies
• GET /:id - Get company by ID (requires authentication)
• PUT /:id - Update company (requires authentication)

Application Routes (/api/v1/applications)

• POST /apply - Apply for a job (requires authentication)
• GET / - Get all applications (requires authentication)
• GET /:id - Get application by ID (requires authentication)
• PUT /:id/status - Update application status (requires authentication)

👥 User Types

Job Seeker

• Can browse and search for jobs
• Can apply for jobs
• Can manage their profile
• Can view application history

Company

• Can post job openings
• Can manage job postings
• Can view and manage applications
• Can update company profile

Admin

• Can manage all companies
• Can oversee all job postings
• Can manage users and applications

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

✍️ Author

Aditya Tripathi

---

Happy Job Hunting! 🚀