🚀 JobStack - Job Portal Platform

A modern full-stack job portal connecting students with companies for career opportunities in the development industry.

✨ Features

For Students

🔐 User Authentication - Secure signup/login with JWT tokens
💼 Job Search - Browse and filter available job opportunities
📝 Easy Applications - Apply to jobs with cover letters
📄 CV Management - Upload and manage resumes
👤 Profile Management - Create and update professional profiles
� Application Tracking - Monitor application status in real-time
🔔 Real-time Notifications - Get instant updates via WebSocket

For Companies

🏢 Company Portal - Dedicated dashboard for recruiters
💼 Job Posting - Create and manage job listings
� Dashboard Analytics - Track active jobs, applications, and metrics
👥 Candidate Management - View applicant profiles and resumes
✅ Application Processing - Shortlist, reject, or hire candidates
� Email Notifications - Automated welcome emails
🔔 Real-time Updates - Instant notifications for new applications

General Features

🎨 Modern UI - Beautiful, responsive design with Tailwind CSS
🌓 Dark Mode Support - Eye-friendly interface options
📱 Mobile Responsive - Works seamlessly on all devices
🔄 Real-time Updates - WebSocket-powered notifications
🔒 Secure - JWT authentication and bcrypt password hashing
⚡ Fast - Optimized performance with React 18 and Vite

🛠️ Tech Stack

Frontend

React 18 - Modern React with hooks
Vite - Lightning-fast build tool
Tailwind CSS - Utility-first CSS framework
Zustand - Lightweight state management
React Router v6 - Client-side routing
Axios - HTTP client with interceptors
Socket.io-client - Real-time WebSocket communication
Lucide React - Beautiful icon library

Backend

Node.js & Express - Server framework
Prisma ORM - Type-safe database client
PostgreSQL - Relational database
JWT - Secure authentication tokens
bcryptjs - Password hashing
Socket.io - WebSocket server
Nodemailer - Email sending
Cookie-parser - Cookie handling
CORS - Cross-origin resource sharing

DevOps

GitHub Actions - CI/CD pipeline
ESLint - Code linting
Prettier - Code formatting

📋 Prerequisites

Node.js 18+ installed
PostgreSQL database (local or hosted)
Git installed
Gmail account (for email notifications)

🚀 Quick Start

Installation

Clone the repository

git clone https://github.com/YOUR_USERNAME/JobStack.git
cd JobStack

Setup Backend

cd Server
npm install

# Create .env file
cp .env.example .env
# Edit .env with your configuration:
# - DATABASE_URL="postgresql://user:password@localhost:5432/jobstack"
# - JWT_SECRET="your-secret-key"
# - EMAIL_USER="your-email@gmail.com"
# - EMAIL_PASS="your-app-password"

# Run database migrations
npx prisma generate
npx prisma migrate dev

# Start the server
npm run dev

Setup Frontend

cd Client
npm install

# Create .env file (optional)
cp .env.example .env

# Install socket.io-client for real-time notifications
npm install socket.io-client clsx tailwind-merge

# Start the development server
npm run dev

Access the application

Frontend: http://localhost:5173
Backend API: http://localhost:3000
Health Check: http://localhost:3000/health

📁 Project Structure

JobStack/
├── Client/                          # Frontend React application
│   ├── src/
│   │   ├── Api/                    # API integration layer
│   │   │   ├── api.js              # Axios instance & API endpoints
│   │   │   ├── hooks.js            # Custom React hooks
│   │   │   ├── store.js            # Zustand state management
│   │   │   └── socket.js           # WebSocket client
│   │   ├── components/             # Reusable components
│   │   │   ├── dashboard/          # Dashboard components
│   │   │   │   ├── DashboardLayout.jsx
│   │   │   │   ├── Sidebar.jsx
│   │   │   │   └── Topbar.jsx
│   │   │   └── grid.jsx            # UI components
│   │   ├── page/                   # Page components
│   │   │   ├── Landing.jsx         # Landing page
│   │   │   ├── Login.jsx           # Login page
│   │   │   ├── Signup.jsx          # Registration
│   │   │   ├── StudentDash.jsx     # Student dashboard
│   │   │   ├── CompanyDash.jsx     # Company dashboard
│   │   │   ├── Jobs.jsx            # Job listings
│   │   │   ├── application.jsx     # Applications view
│   │   │   ├── Userprofile.jsx     # User profile
│   │   │   └── ...
│   │   ├── App.jsx                 # Main app component
│   │   └── main.jsx                # Entry point
│   ├── public/                     # Static assets
│   ├── .env.example                # Environment variables template
│   ├── tailwind.config.js          # Tailwind configuration
│   ├── vite.config.js              # Vite configuration
│   └── package.json
│
├── Server/                          # Backend Node.js application
│   ├── controllers/                # Route controllers
│   │   ├── Auth/                   # Authentication controllers
│   │   ├── Company_Dashboard/      # Company-specific controllers
│   │   │   ├── job.controllers.js
│   │   │   ├── application.controllers.js
│   │   │   └── profile.controllers.js
│   │   ├── User_Dashboard/         # User-specific controllers
│   │   │   ├── application.controllers.js
│   │   │   ├── profile.controllers.js
│   │   │   └── cv.controllers.js
│   │   └── Jobs/                   # Job-related controllers
│   ├── routes/                     # API routes
│   │   ├── Auth/                   # Authentication routes
│   │   ├── Dashboard/              # Dashboard routes
│   │   ├── Jobs/                   # Job routes
│   │   └── mainRoute.js            # Main router
│   ├── middlewares/                # Express middlewares
│   │   ├── auth.Middleware.js      # JWT authentication
│   │   └── upload.Middleware.js    # File upload handling
│   ├── prisma/                     # Database schema & migrations
│   │   ├── schema.prisma           # Prisma schema
│   │   └── migrations/             # Database migrations
│   ├── utils/                      # Utility functions
│   │   ├── email.js                # Email configuration
│   │   ├── sendEmail.js            # Email sending utility
│   │   └── validator.js            # Input validation
│   ├── db/                         # Database configuration
│   │   └── config.js               # Prisma client
│   ├── websocket.js                # Socket.io configuration
│   ├── server.js                   # Express server entry point
│   ├── .env.example                # Environment variables template
│   └── package.json
│
└── .github/
    └── workflows/                   # CI/CD pipelines
        └── ci.yml                   # GitHub Actions workflow

🔐 Database Schema

Models

User - Student accounts with profile information
Company - Company accounts with organization details
Job - Job postings created by companies
Applications - Job applications from users
Profile_user - Extended user profile information
Profile_companies - Extended company profile information
Document - User uploaded CVs and resumes
College - College/University information

🔄 API Endpoints

Authentication

POST /api/auth/signup/user - User registration
POST /api/auth/signup/company - Company registration
POST /api/auth/login/user - User login
POST /api/auth/login/company - Company login

Jobs (Public)

GET /api/jobs - Get all jobs
GET /api/jobs/:id - Get job by ID

User Dashboard (Protected)

GET /api/User_dashboard/profile - Get user profile
POST /api/User_dashboard/profile - Update user profile
POST /api/User_dashboard/cv - Upload CV
POST /api/User_dashboard/apply/:jobId - Apply to job
GET /api/User_dashboard/applications - Get user applications

Company Dashboard (Protected)

GET /api/Company_dashboard/overview - Get company overview
POST /api/Company_dashboard/post_job - Create job posting
GET /api/Company_dashboard/jobs - Get company jobs
GET /api/Company_dashboard/applications - Get all applications
PUT /api/Company_dashboard/applications/:id/status - Update application status
GET /api/Company_dashboard/profile - Get company profile
POST /api/Company_dashboard/profile - Update company profile

🔄 CI/CD Pipeline

This project includes automated CI pipeline that:

✅ Builds both frontend and backend
✅ Runs linting checks
✅ Executes tests
✅ Verifies deployment readiness
✅ Uploads build artifacts

Pipeline runs on every push and pull request to main/master/develop branches.

🔔 WebSocket Integration

Real-time Notifications

The application uses Socket.io for real-time notifications:

Automatic connection on user login
JWT-based authentication for WebSocket
Real-time job posting notifications
Application status updates
Browser notifications support

Implementation

// Client automatically connects on login
useNotifications(); // Custom hook handles connection

// Server sends notifications
notifyUser(userId, {
  title: "New Job Posted",
  message: "Check out the latest opportunities!",
  createdAt: new Date(),
});

📧 Email Notifications

Automated emails are sent for:

Welcome emails on signup (both students and companies)
Job application confirmations
Application status updates
Password reset (if implemented)

🧪 Running Tests

# Frontend tests
cd Client
npm test

# Backend tests
cd Server
npm test

📝 Environment Variables

Backend (.env)

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/jobstack"

# JWT
JWT_SECRET="your-super-secret-jwt-key"

# Server
PORT=3000
NODE_ENV=development

# Email (Gmail)
EMAIL_USER="your-email@gmail.com"
EMAIL_PASS="your-app-password"  # Use App Password, not regular password

# Frontend URL (for CORS)
FRONTEND_URL="http://localhost:5173"

Frontend (.env)

# API URL
VITE_API_URL="http://localhost:3000/api"

# WebSocket URL
VITE_SOCKET_URL="http://localhost:3000"

🚀 Deployment

Frontend (Vercel/Netlify)

Build the project: npm run build
Deploy the dist folder
Set environment variables in your hosting platform

Backend (Railway/Render/Heroku)

Set up PostgreSQL database
Configure environment variables
Run migrations: npx prisma migrate deploy
Deploy the server

🔒 Security Features

JWT-based authentication
Bcrypt password hashing (10 rounds)
Role-based access control (RBAC)
Protected routes with middleware
CORS configuration
Cookie-based session management
Input validation and sanitization

📊 Key Features Breakdown

Dashboard System

Student Dashboard: Track applications, manage profile, upload CV
Company Dashboard: Post jobs, view applications, hire candidates
Analytics: Real-time metrics and statistics
Responsive Design: Mobile-friendly interface

Application System

Easy Apply: One-click application with cover letter
Status Tracking: PENDING → SHORTLISTED → HIRED/REJECTED
Resume Viewing: Companies can view candidate resumes
Bulk Actions: Mark all as read, clear notifications

Job Management

Create Jobs: Post new opportunities
Edit Jobs: Update job details
Delete Jobs: Remove listings
Job Filters: Search and filter by criteria

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

🐛 Known Issues

None at the moment. Please report issues on GitHub.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Authors

Krishna Gehlot - @krishnagehlot

🙏 Acknowledgments

Built with ❤️ using React and Node.js
UI inspired by modern job portals like LinkedIn and Indeed
Icons by Lucide Icons
Animations and UI components inspired by Aceternity UI

📞 Support

For support, email krishnagehlot@example.com or open an issue on GitHub.

🎯 Roadmap

Add advanced search filters
Implement chat system between companies and candidates
Add video interview scheduling
Resume parsing with AI
Job recommendations based on user profile
Mobile app (React Native)
Advanced analytics dashboard
Multi-language support

Made with 💙 by Krishna Gehlot

Name		Name	Last commit message	Last commit date
Latest commit History 77 Commits
.github/workflows		.github/workflows
Client		Client
Server		Server
.DS_Store		.DS_Store
.gitignore		.gitignore
README.md		README.md
tailwind.config.js		tailwind.config.js

Folders and files

Latest commit

History

Repository files navigation