🚀 HireHub AI — Smart Job Portal

A full-stack-style job portal experience (Candidate + Company + Admin) built entirely with pure HTML, CSS & JavaScript

🚀 Live Demo · ✨ Features · 🛠 Tech Stack · 📦 Installation · 🔑 Demo Logins

---

📖 About The Project

HireHub AI is a demo recruitment platform that simulates the three sides of a real job portal — Candidates, Companies/Recruiters, and Admins — in one client-side web application. It covers the full candidate journey (profile building, resume creation, ATS scoring, applying, interviews, assessments) and the full recruiter journey (posting jobs, reviewing applicants, scheduling interviews, sending offers), plus an admin panel for platform-wide oversight and analytics.

It was built to demonstrate that a genuinely complex, multi-role application — the kind normally requiring a backend, database, and authentication server — can be prototyped entirely with vanilla HTML, CSS, and JavaScript, using localStorage as a stand-in data layer. Every "AI" feature is implemented as transparent, rule-based logic rather than a connected language model — a deliberate, honest design choice explained further below.

---

🚀 Live Demo

🔗 https://itsmeankita.github.io/HireHub-AI/

🔑 Demo Logins

Role	Email	Password
Admin	admin@demo.com	admin123
Company (TechNova)	hr@technova.demo	demo123
Company (CloudPeak)	hr@cloudpeak.demo	demo123
Candidate	(sign up fresh — takes 30 seconds)	—

The app seeds itself with 3 demo companies and 8 sample job listings on first load, so there's always data to explore.

---

✨ Features

🎓 Candidate Signup/Login with OTP verification (demo) Dashboard with analytics & achievement badges Full profile builder — education, experience, projects, certifications, internships, skills, links Multiple resume uploads with version history Profile completion tracker Resume Builder with live preview + PDF export ATS Resume Score with missing-keyword detection AI Resume Review (rule-based checklist) Job search, filters, save/bookmark, recently viewed One-click apply with auto-filled cover letters Application tracking with status timeline Interview schedule + prep checklist QR digital portfolio + digital signature pad

🤖 AI Tools (rule-based) AI Cover Letter Generator AI Job Recommendations (skill-overlap matching) Skill Gap Analysis per job AI Salary Estimator Career Roadmap Generator (6 tracks) AI Mock Interview Chatbot (HR & Technical rounds) Company Eligibility Checker Referral request module Recruiter rating system 📝 Assessments Aptitude, Coding/MCQ, Technical & HR quiz banks Timed quiz engine with instant scoring Scorecard history per candidate

🏢 Company / Recruiter Company dashboard & profile Post / edit / close job listings View applicants per job Shortlist, reject, schedule interviews Interview feedback & outcome recording Offer letter generator (PDF, demo) Referral request inbox 👨‍💼 Admin Platform-wide dashboard Manage users, jobs, applications, interviews Reports: job trends, skill demand, company-wise applications, placement & interview success rate 🌐 General Dark/Light mode · Responsive design In-app notification center Global search across jobs & companies Full data export/import (JSON backup)

---

🛠️ Tech Stack

Layer	Technology
Structure	HTML5
Styling	CSS3 (Custom Properties, Glassmorphism, Flex/Grid)
Logic	Vanilla JavaScript (ES6+)
PDF Export	jsPDF
QR Codes	QR Server API
Persistence	Browser LocalStorage (namespaced per role/entity)

No build tools, no bundlers, no backend server — it just runs.

---

📁 Project Structure

HireHub-AI/
├── index.html      # App shell — auth screen + all view containers
├── style.css        # Design system, themes, components
├── script.js         # Entire application logic, split into clear modules:
│                        auth, candidate profile, resume/ATS/AI tools,
│                        jobs, applications/interviews/assessments,
│                        company panel, admin panel, shared modals
└── README.md

---

📦 Installation & Setup

No installation needed — it's a static site.

Option 1 — Run locally

git clone https://github.com/Itsmeankita/HireHub-AI.git
cd HireHub-AI

Then simply open index.html in any modern browser.

Option 2 — Use it live Visit the Live Demo link above, or log in with one of the demo accounts.

---

🧠 How It Works (Key Design Notes)

• Role-based single-page app: One index.html renders three completely different navigation sets and view collections depending on whether the logged-in user is a Candidate, Company, or Admin — all client-side, no page reloads.
• LocalStorage as a database: Users, profiles, jobs, applications, interviews, assessments, and notifications are each stored under their own namespaced key, mimicking how separate database tables would be structured.
• Honest "AI": Every AI-labeled feature (resume review, cover letter generation, job matching, salary estimation, mock interview chat) runs on deterministic, explainable logic — keyword overlap, weighted formulas, and template banks — not a connected large language model. This is called out explicitly rather than implied.
• Seeded demo data: On first load, the app seeds 3 companies and 8 jobs so the platform feels alive immediately, without requiring manual setup before a demo or interview walkthrough.

---

📌 Honest Notes / Scope

• This is a frontend demo/prototype — authentication is simplified (plaintext passwords in LocalStorage) and is not production-secure. It exists to demonstrate UX and feature breadth, not to be deployed as a real recruitment platform handling real user data.
• Email notifications, SMS reminders, meeting links, offer letters, and document/certificate verification are all clearly labeled "Demo" — they simulate the UI/flow without actually sending anything externally.
• All data lives in your browser's LocalStorage and is never transmitted anywhere.

👤 Author

Ankita Kumari (@Itsmeankita) 3rd Year Computer Science Engineering Student

📄 License

This project is open source and available under the MIT License.

---

⭐ If you found this project useful, consider giving it a star!