Bridging talent and opportunity in one intelligent, full-stack career platform.
SkillBridge is a modern MERN-stack job portal connecting Candidates, Recruiters, and Administrators. It integrates AI-powered voice career coaching, automated real-time mock interviews, multi-source job aggregation (Adzuna, Workday, career boards), verified company branding, and enterprise-grade security middleware.
- Production App: https://job-portal-system-alpha.vercel.app
- Backend API: Hosted on Oracle Cloud Infrastructure (OCI) with MongoDB Atlas, Redis caching, and automated cron syncs.
- π€ DHRUV Voice Coach: Interactive career mentor supporting Speech-to-Text (STT) and Text-to-Speech (TTS) voice readback for job matching and resume coaching.
- ποΈ TRAO AI Mock Interview Assistant (In Integration / Local Preview): Domain-tailored technical & behavioral interviews with real-time speech responses, scoring rubrics, and feedback powered by Gemini / Groq with heuristic fail-safes (gated in production; enabled locally).
- π Unified Job Aggregator Engine: Automated aggregator syncing live openings across Adzuna, Workday, and employer portals with intelligent deduplication and SDE lifecycle management (Active / Stale / Dormant).
- π Structured Description & Translation Engine: Auto-repairs scraped postings into 9 standardized sections (
Role Summary,Key Responsibilities,Required Qualifications, etc.) and translates foreign-language listings into clear English. - π¨ Verified Brand Logos: High-fidelity company branding system resolving verified logos from Clearbit, Brandfetch, SVGL, and custom vector SVGs with strict fallback guards.
- π Enterprise Security Architecture: Custom CSRF protection middleware, security audit logging, time-expiring signed Cloudinary resume URLs, and resilient STARTTLS email dispatching.
- π§ͺ Comprehensive CI Quality Gate: Automated dual-stage CI pipeline running 20 test suites (112 unit tests) and frontend linting/compilation before deployment.
graph TD
%% Custom Styles
classDef client fill:#38bdf8,stroke:#0284c7,stroke-width:2px,color:#0f172a
classDef api fill:#334155,stroke:#64748b,stroke-width:2px,color:#f8fafc
classDef ai fill:#a855f7,stroke:#9333ea,stroke-width:2px,color:#ffffff
classDef db fill:#22c55e,stroke:#16a34a,stroke-width:2px,color:#ffffff
classDef ext fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#ffffff
subgraph ClientLayer ["π₯οΈ Frontend (React 19 + Vite)"]
UI["Candidate / Recruiter / Admin UI"]:::client
VoiceCoach["DHRUV Voice AI (Web Speech API)"]:::ai
InterviewUI["AI Mock Interview Console"]:::ai
end
subgraph BackendLayer ["βοΈ Core API & Middleware"]
Gateway["Express Router & CSRF Middleware"]:::api
AuthGuard["JWT Auth & Security Audit Logger"]:::api
DescService["Full Description & Translation Service"]:::api
SyncEngine["Unified Sync & SDE Lifecycle Engine"]:::api
end
subgraph IntelligenceLayer ["π§ AI & External Services"]
LLM["Google Gemini / Groq API"]:::ai
LogoResolver["Verified Brand Logo Resolver"]:::ext
Adzuna["Adzuna Career API"]:::ext
Workday["Workday Career Plugin"]:::ext
end
subgraph StorageLayer ["ποΈ Persistence & Cloud Storage"]
Atlas[("MongoDB Atlas")]:::db
Cloudinary["Cloudinary (Signed Resumes)"]:::ext
Mailer["Nodemailer (STARTTLS)"]:::ext
end
%% Interactions
UI -->|"HTTPS & Bearer / CSRF"| Gateway
VoiceCoach -.->|"Speech-to-Text / Audio"| UI
InterviewUI -->|"Answer Submission"| Gateway
Gateway --> AuthGuard
AuthGuard --> DescService
AuthGuard --> SyncEngine
SyncEngine -->|"Job Polling"| Adzuna
SyncEngine -->|"Requisition Parsing"| Workday
SyncEngine -->|"Fetch Brand Assets"| LogoResolver
DescService -.->|"Heuristic / AI Expansion"| LLM
Gateway -.->|"Email Alerts"| Mailer
Gateway -->|"Document Storage"| Cloudinary
Gateway -->|"Data CRUD"| Atlas
SyncEngine -->|"Bulk Upsert"| Atlas
| Domain | Technologies |
|---|---|
| Frontend | React 19, Vite, Tailwind CSS, Lucide React, React Router v7, Axios, Web Speech API |
| Backend | Node.js (v20+), Express.js (v5), Mongoose, Cheerio, JWT Authentication |
| Database & Caching | MongoDB Atlas, Redis Caching, In-Memory Fallbacks |
| AI & Natural Language | Google GenAI (Gemini), Groq API, Rule-Based Natural Language Parsers |
| Storage & Media | Cloudinary (Signed Expiring Resume URLs) |
| Email & Alerts | Nodemailer with RFC-compliant STARTTLS fallback |
| Job Aggregation | Adzuna API, Workday Career Scraper, SDE Priority Crawl Scheduler |
| Branding & Logos | Clearbit Logo API, Brandfetch, SVGL, Vector SVG Brand Assets |
| Testing & CI/CD | Jest, Supertest, ESLint, GitHub Actions (Dual CI Quality Gates), Vercel |
- Smart Job Search & Filtering: Filter by title, tech stack, location, salary range, and work mode (Remote / Hybrid / On-site).
- One-Click Application Flow: Apply seamlessly with uploaded resumes, personal details, and instant status tracking.
- Application History: Track requisition states (
Pending,Reviewed,Shortlisted,Rejected) with real-time updates. - Saved Opportunities: Bookmark roles for later review with persistent candidate dashboards.
- DHRUV Voice Coach: Ask career questions verbally and listen to tailored recommendations in real time.
- TRAO AI Mock Interview Room (In Integration / Local Preview): Practice technical questions with speech input, automated evaluation, and actionable feedback.
- Job Requisition Management: Draft, publish, edit, feature, and close job postings.
- Applicant Tracking Pipeline: View candidates per role, inspect authenticated resume previews, and update candidate stages.
- Direct Candidate Notifications: Automatic branded email notifications sent on application status updates.
- System Metrics: Real-time overview of total platform users, active listings, job sync health, and applications.
- Manual & Scheduled Sync Controls: On-demand triggers for job crawlers and synchronization diagnostics.
- User Feedback & Moderation: Manage candidate inquiries, hide invalid job postings, and review security audit logs.
The project enforces strict automated checks on every pull request and push to main:
# Backend Test Suite (20 Test Suites | 112 Tests)
cd backend
npm test -- --runInBand --forceExit
# Frontend Lint & Production Compilation
cd ../frontend
npm run lint
npm run build- Security & CSRF: Verifies header presence, CSRF token generation, origin validation, and state-changing verb protection.
- Full Description Service: Tests JSON-LD extraction, HTML sanitization, section categorization, bullet list parsing, and employer posting validation.
- Sync & Lifecycle Engine: Validates deduplication, crawl priority scheduling (Active / Stale / Dormant), and Workday plugin integration.
- TRAO AI Interview Assistant: Tests fallback heuristics when AI APIs are unreachable, scoring accuracy, and domain question generation.
git clone https://github.com/Chinmay0608/job-portal-system.git
cd job-portal-systemcd backend
npm installCreate a .env file in the backend/ directory:
PORT=5000
NODE_ENV=development
MONGODB_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net/job-portal
JWT_SECRET=your_jwt_secret_key
SYNC_SECRET_KEY=your_sync_secret_key
# Cloudinary (Resume Storage)
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_key
CLOUDINARY_API_SECRET=your_cloudinary_secret
# Email Dispatch
EMAIL_USER=SkillBridge684@gmail.com
EMAIL_PASS=your_gmail_app_password
# Job APIs (Optional for external crawl)
ADZUNA_APP_ID=your_adzuna_id
ADZUNA_APP_KEY=your_adzuna_key
# AI Services (Optional for AI interview & translation)
GEMINI_API_KEY=your_gemini_key
GROQ_API_KEY=your_groq_key
# Allowed Origins
FRONTEND_URL=http://localhost:5173
ALLOWED_ORIGINS=http://localhost:5173Start the backend:
npm run devcd ../frontend
npm installCreate a .env file in the frontend/ directory:
VITE_API_BASE_URL=http://localhost:5000
VITE_FIREBASE_API_KEY=your_firebase_api_keyStart the Vite development server:
npm run devVisit http://localhost:5173 to explore SkillBridge locally.
Copyright (c) 2026 Chinmay Maheshwari. All Rights Reserved.
This software, source code, and associated documentation are proprietary and confidential. Unauthorized copying, modification, reproduction, or distribution of this software or any portion of it, via any medium, is strictly prohibited.
For licensing, business inquiries, or platform support:
- Lead Developer & Owner: Chinmay Maheshwari
- Official Support: SkillBridge684@gmail.com
- GitHub Repository: Chinmay0608/job-portal-system