LWS Job Portal is a full-stack recruitment platform that serves two distinct audiences — job seekers hunting for their next opportunity and companies looking to attract and manage talent. This page gives you a complete overview of what the platform offers, the roles it supports, and the technology stack that powers it end to end.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/iDevRanjan/lws-ra-b4-assignment-five/llms.txt
Use this file to discover all available pages before exploring further.
Who Is LWS Job Portal For?
The platform is built around a clear two-role model:- USER (Job Seeker) — Individuals who want to search for jobs, track applications, and maintain a professional profile.
- COMPANY (Employer) — Organizations that post job listings, review applicants, and manage their public company profile.
Key Features
Job Seeker Features
Advanced job search and filtering, infinite scroll powered by
useInfiniteQuery, real-time application tracking, profile management, and personalized job recommendations — all optimized with a custom useDebounce hook.Company Features
A full job management dashboard for posting and editing listings, an applicant tracking system with cover letter previews, and a public company profile showcasing culture, social links, and open roles.
Auth & Routing
Role-based authentication with separate login and registration flows for users and companies. Protected navigation is enforced via
RoleBasedRoute on the frontend and protect/authorize middleware on the backend.Performance & UX
Skeleton loading states replace spinners, toast notifications confirm every action, and React Router v7 loaders prefetch data before a page renders to eliminate layout shifts.
Job Seeker Features
- Advanced Search & Filtering — Filter by category, job type (Full-time / Part-time), work mode (Remote / On-site), salary range, and required skills.
- Infinite Scrolling — Smooth, pagination-free job browsing using TanStack Query’s
useInfiniteQuery. - Application Management — Apply via “Apply Now”, track application status in real time, and withdraw with a single click.
- Profile Management — Update education, experience, skills, and contact details from a dedicated dashboard.
- Similar & Recommended Jobs — Contextual job suggestions on every job detail page.
Company Features
- Job Management Dashboard — Create, edit, and manage all active job postings from one place (
CreateAndEditJob). - Applicant Tracking — See applicant counts per job, open individual applicant profiles, and read cover letters via
CoverLetterModal. - Public Company Profile — A branded page displaying company description, culture, social media links, and current openings.
Technical & Core Features
- Smart State Management — TanStack React Query handles all server state; a custom
useSyncExternalStorePub-Sub store manages auth and local state without any third-party library. - Advanced Error Handling — React Router loaders,
errorElementboundaries, and a catch-allpath: "*"route ensure errors are surfaced cleanly in the affected section rather than crashing the entire page. - Skeleton UX — Components like
JobCardSkeletonandApplicantsCardSkeletonmaintain visual stability during data fetches. - Toast Notifications —
react-hot-toastprovides feedback for every user action including login, application submission, and profile updates.
Technology Stack
| Layer | Technology | Version |
|---|---|---|
| UI Library | React | 19+ |
| Build Tool | Vite | 8.x |
| Server State | TanStack React Query | 5.x |
| Routing | React Router | 7.x |
| Forms | React Hook Form | 7.x |
| Styling | Tailwind CSS | 4.x |
| HTTP Client | Axios | 1.x |
| Icons | Lucide React | 0.5x |
| Notifications | React Hot Toast | 2.x |
| Backend Framework | Express | 5.x |
| ORM | Sequelize | 6.x |
| Database | SQLite | 5.x |
| Auth | JSON Web Tokens (JWT) | 9.x |
| Password Hashing | bcryptjs | 3.x |
| File Uploads | Multer | 2.x |
Explore the Documentation
Quickstart
Get both servers running locally in under 10 minutes with step-by-step setup instructions.
Architecture
Understand the monorepo layout, frontend structure, backend patterns, and data flow.
Job Seekers Guide
Learn how to register, search for jobs, apply, and manage your professional profile.
API Reference
Full reference for every REST endpoint exposed by the Express backend.