TalentHub - Job Portal Platform

A modern, full-stack job portal application connecting job seekers with employers. Built with the MERN stack and deployed on Vercel and Render.

🚀 Live Demo

Frontend: https://talenthub-frontend-mu.vercel.app/

Backend API: https://talent-hub-backend-ozgh.onrender.com

🌟 Features

For Job Seekers

• ✅ Browse and search jobs with advanced filters
• ✅ Apply for jobs with cover letters
• ✅ Track application status in real-time
• ✅ Manage profile and preferences
• ✅ View application history

For Employers

• ✅ Post and manage job listings
• ✅ Review and process applications
• ✅ Analytics dashboard with insights
• ✅ Applicant management system
• ✅ Company profile management

🛠️ Tech Stack

Frontend

• React.js 18 - Modern UI framework
• React Router DOM - Client-side routing
• Tailwind CSS - Utility-first styling
• Framer Motion - Smooth animations
• Axios - HTTP client
• Lucide React - Modern icons

Backend

• Node.js - JavaScript runtime
• Express.js - Web framework
• MongoDB Atlas - Cloud database
• Mongoose - MongoDB object modeling
• JWT - Authentication
• bcryptjs - Password hashing

Deployment

• Frontend: Vercel
• Backend: Render
• Database: MongoDB Atlas

🏗️ Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   React.js      │    │   Express.js    │    │   MongoDB       │
│   (Frontend)    │◄──►│   (Backend)     │◄──►│   (Database)    │
│   Vercel        │    │   Render        │    │   Atlas         │
└─────────────────┘    └─────────────────┘    └─────────────────┘

📱 Screenshots

Coming soon - Add screenshots of your application

🔐 Authentication

• JWT-based authentication system
• Role-based access control (Job Seeker / Employer)
• Protected routes and API endpoints
• Secure password hashing

🔍 Key Functionalities

1. Real-time Job Search - Advanced filtering by location, salary, type, experience
2. Application Management - Complete application lifecycle tracking
3. Dashboard Analytics - Performance metrics for employers
4. Responsive Design - Mobile-first approach
5. Error Handling - Comprehensive error boundaries

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• MongoDB Atlas account
• Git

Local Development

1. Clone the repository

   git clone https://github.com/Pranjal1423/TalentHub.git
   cd TalentHub

2. Setup Backend

   cd backend
   npm install
   # Create .env file with your MongoDB URI and JWT secret
   npm run dev

3. Setup Frontend

   cd frontend
   npm install
   npm start

4. Environment Variables

   Backend .env:

   MONGODB_URI=your_mongodb_connection_string
   JWT_SECRET=your_jwt_secret
   CLIENT_URL=http://localhost:3000

   Frontend .env:

   REACT_APP_API_URL=http://localhost:5000/api

📡 API Endpoints

Authentication

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• GET /api/auth/profile - Get user profile
• PUT /api/auth/profile - Update profile

Jobs

• GET /api/jobs - Get all jobs (with filters)
• POST /api/jobs - Create job (employer only)
• GET /api/jobs/:id - Get specific job
• POST /api/jobs/:id/apply - Apply for job
• GET /api/jobs/my/applications - Get user applications

🎨 Design Features

• Modern, clean UI with Tailwind CSS
• Smooth animations with Framer Motion
• Responsive design for all devices
• Intuitive user experience
• Professional color scheme

🔧 Performance Optimizations

• Code splitting and lazy loading
• Image optimization
• API response caching
• Database indexing
• Error boundaries

📈 Future Enhancements

• Real-time chat between employers and applicants
• Video interview integration
• AI-powered job recommendations
• Resume builder tool
• Mobile application
• Advanced analytics dashboard

🤝 Contributing

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

📄 License

This project is licensed under the MIT License.

👨‍💻 Developer

Pranjal - GitHub Profile

---

⭐ If you found this project helpful, please give it a star! ⭐