Skip to main content

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.

LWS Job Portal is a full-stack recruitment platform built with React 19, React Router v7, TanStack React Query, and an Express + SQLite backend. The platform provides two distinct user experiences: job seekers can search, filter, and apply for positions, while companies can post jobs, review applicants, and manage their full recruitment pipeline.

Quickstart

Get the frontend and backend running locally in minutes

Architecture

Understand the project structure, data flow, and design decisions

For Job Seekers

Search jobs, apply, manage applications, and build your profile

For Companies

Post jobs, track applicants, and manage your recruitment pipeline

API Reference

Full REST API documentation for all endpoints

Technical Guide

Deep dive into state management, routing, and data fetching patterns

​
What’s Inside

LWS Job Portal ships with a production-ready feature set covering the full hiring lifecycle.

Advanced Job Search

Filter by category, job type, work mode, salary range, and required skills with debounced search and infinite scroll

Role-Based Auth

Separate registration and protected routes for USER (job seekers) and COMPANY roles, secured with JWT

Application Tracking

Full lifecycle — apply, track real-time status updates, review cover letters, and withdraw applications

Company Dashboard

Stats overview, recent applicants list, open positions, and applicant profile deep-dives

​
Getting Started

1

Clone the repository

Clone the project and navigate into the root directory.
git clone https://github.com/iDevRanjan/lws-ra-b4-assignment-five.git
cd lws-ra-b4-assignment-five
2

Start the backend

Install backend dependencies, configure environment, and start the Express server.
cd backend
npm install
# create backend/.env with PORT=5000
npm run dev
3

Start the frontend

Install frontend dependencies, configure the API base URL, and start Vite.
cd ..
npm install
# create .env with VITE_API_BASE_URL=http://localhost:5000
npm run dev
4

Open in browser

Visit http://localhost:5173 to see the running application. Register as a job seeker or company to explore the full feature set.
Both the backend API server and the frontend dev server must be running simultaneously. The frontend will show a blank state if the backend is unreachable.

Build docs developers (and LLMs) love

Get started for freeTalk to us