A modern, full-stack Job Portal built with the powerful MERN stack — enabling both job seekers (students) and recruiters to connect seamlessly. With a clean, animated, and responsive UI, this platform allows users to explore opportunities, post jobs, and manage applications with ease.

• 🔐 Authentication System — Secure login & registration using JWT
• 👥 Role-Based Access — Separate dashboards for students and recruiters
• 🌐 Clean, Responsive UI — Built with Tailwind CSS & shadcn/ui
• 🎯 Dynamic Routing & State Management — Smooth navigation across the app

• Browse and search job listings
• Apply to jobs with one click
• Track application status in personal dashboard

• Post new job opportunities
• View applicants for each job
• Edit or delete job postings
• Manage all listings from a unified dashboard

The UI is built with Tailwind CSS and enhanced with shadcn/ui components for consistency and accessibility. Smooth animations and transitions are added using Framer Motion, delivering a modern and engaging user experience.

• Responsive layout for mobile, tablet, and desktop
• Dark/light mode support (optional if implemented)
• Animated modals, buttons, and transitions
• Accessible and consistent component design

• React.js – Component-based architecture
• Tailwind CSS – Utility-first CSS for clean, responsive UI
• shadcn/ui – Beautiful, headless UI components
• Framer Motion – Animations and motion effects
• React Router – Client-side routing
• Axios – API communication

• Node.js – Server-side JavaScript runtime
• Express.js – Web framework for APIs
• MongoDB – NoSQL database for storing user/job data
• Mongoose – MongoDB object modeling for Node.js
• JWT (JSON Web Token) – Authentication and authorization

• Users register/login with their email and password

• JWT tokens are issued and stored securely

• Access is restricted based on user roles (student/recruiter)

• Protected routes for job posting, applications, and dashboards

git clone https://github.com/jawad9/job-portal
cd job-portal

Create a .env file inside the server/ directory with:

MONGODB_URI = ""
PORT = 8000
SECRET_KEY = ""

CLOUDINARY_API_KEY = ""
CLOUDINARY_SECRET_KEY = ""
CLOUDINARY_NAME = ""

NODE_ENV === ""

# Install frontend packages
cd client
npm install

# Install backend packages
cd ../server
npm install

# Start backend server
cd server
npm run dev

# Start frontend dev server
cd ../client
npm start

• Frontend → http://localhost:5137
• Backend → http://localhost:5000

• This project is open-source and licensed under the MIT License.

Feel free to fork the repo, submit issues, or open a pull request. Suggestions and contributions are always welcome!