Skip to content

A full-stack candidate referral system built with React and Node.js featuring resume upload, candidate status tracking, and form validation.

Notifications You must be signed in to change notification settings

dattatrayaSamal/referral-system-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 

Repository files navigation

🎯 Referral System App

A full-stack application built with React (frontend) and Node.js + Express + MongoDB (backend).

✅ Includes form validations, resume uploads, error handling, and clean UI.

📸 Dashboard Screenshot

Dashboard

✨ Features

  • Refer new candidates (Name, Email, Phone, Job Title, PDF Resume)
  • View all referred candidates
  • Update candidate status (Pending, Reviewed, Hired)
  • Form validations on frontend & backend
  • Resume uploads stored on server
  • Error handling and user feedback

🚀 Running the Project Locally

Backend


        cd backend
        npm install
        nodemon server.js
    

Backend will run on: http://localhost:8000

Frontend


        cd frontend/project
        npm install
        npm run dev
    

Frontend will run on: http://localhost:5173

⚙️ API Endpoints

MethodEndpointDescription
GET/api/candidatesFetch all candidates
POST/api/candidatesRefer a new candidate
PUT/api/candidates/:id/statusUpdate candidate status

📌 Assumptions & Limitations

  • Phone must be 10 digits
  • Email must be valid
  • Resume must be a PDF
  • No authentication implemented
  • Files stored locally
  • Runs locally only (no deployment)

About

A full-stack candidate referral system built with React and Node.js featuring resume upload, candidate status tracking, and form validation.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published