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.

The company dashboard at /company-dashboard is the central hub for every recruiter using LWS Job Portal. As soon as you log in with a COMPANY role account, you land here to see a real-time summary of your hiring activity — how many jobs are live, how many candidates have applied, who is waiting for review, and how many have been shortlisted — all without leaving a single screen.

​
Dashboard Stats

The stats row at the top of the page is powered by the DashboardStats component, which calls GET /api/companies/dashboard/stats. It returns four key numbers that update every time you revisit the page.
StatWhat It Counts
Active JobsJobs currently in Active status
Total ApplicantsTotal number of applications submitted across all your job listings
Pending ReviewsApplications still in New status awaiting action
ShortlistedApplications you have moved to Shortlisted status
// GET /api/companies/dashboard/stats — example response
{
  "success": true,
  "data": {
    "totalJobs": 12,
    "activeJobs": 5,
    "totalApplicants": 84,
    "totalApplications": 91,
    "pendingReviews": 37,
    "shortLists": 14
  }
}
Jobs with detailed descriptions receive significantly more quality applicants. Keep your postings updated with accurate requirements, compensation ranges, and benefits.

​
Open Positions

The Open Positions section lists all of your currently active job postings. Each listing shows the job title, type, work mode, location, and the number of applications it has received. Clicking a listing opens the public job detail page so you can verify exactly what candidates see.

​
Recent Applicants

Below the Open Positions panel, the Recent Applicants section surfaces the latest applications across every job you have posted. Each entry shows the applicant’s name, email, the time elapsed since they applied, and their current status badge. From this panel you can:
  • Click View Profile to open the full applicant profile at /applicants/:applicantId.
  • Click Resume to download or preview the applicant’s resume in a new tab.
  • Click Cover Letter to open a modal displaying the applicant’s cover letter text.
  • Use the Applicant Status dropdown to immediately update the application status without navigating away.
A View All link in the panel header takes you to the dedicated Applicants page at /applicants.

​
Quick Actions Sidebar

The sidebar on the right side of the dashboard provides one-click access to the most common company tasks.

Manage Jobs

View, edit, filter, and delete all your job postings from a paginated table.

Post New Job

Open the job creation form and publish a new listing in minutes.

View Applicants

See every candidate who has applied across all your active jobs.

Company Settings

Update your company profile, logo, contact details, and social links.

​
Public Company Profile

Every registered company gets a public-facing profile page at /companies/:companySlug. Job seekers can visit this page without logging in. The profile is assembled from the data stored in the Company model and is served by GET /api/companies/:slug.

​
Profile Sections

The header displays the company logo, name, industry, employee count, and a link to the company website. This information comes from the logoUrl, name, industry, employeeCount, and websiteUrl fields of the Company model.
The main body shows the company description — a free-text overview of what the company does — along with culture and values content surfaced by the CompanyCultureValues component.
The sidebar on the public profile lists the company’s HR email (hrEmail), info email (infoEmail), phone, and address fields (city, state, country, and the general location string).
Active job listings are fetched from GET /api/companies/:slug/jobs and displayed so that visitors can apply directly from the company profile page.

​
Company Settings

The Company Settings page is available at /company-settings via the quick actions sidebar.
Company Settings is currently under active development. The page shows a “Development in Progress” indicator. Full profile editing — including logo upload, description, contact details, and social links — will be available in an upcoming release.

Build docs developers (and LLMs) love

Get started for freeTalk to us