Skip to content

README.md

Latest commit

 

History

History
204 lines (131 loc) · 5.62 KB

README.md

File metadata and controls

204 lines (131 loc) · 5.62 KB

React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

Expanding the ESLint configuration

If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the TS template for information on how to integrate TypeScript and typescript-eslint in your project.

🚀 Recruitment Portal – React + Vite Frontend

Vite React Bootstrap JavaScript License Live Demo

🌟 Recruitment Portal – Overview

Welcome to the Recruitment Portal! 🎯
A React + Vite frontend application built for job seekers and employers. The portal offers a clean, responsive interface, ready API integration, and smooth navigation across all devices.

“A professional recruitment experience, fully responsive and easy to use.”

📌 Table of Contents

  1. Features
  2. Technologies Used
  3. Project Structure
  4. Getting Started
  5. Usage
  6. API Integration
  7. Screenshots
  8. Future Enhancements
  9. Crafted by

✨ Features

  • Job Seeker: Browse jobs, apply, track applications ✅

  • Employer: Post jobs, manage applicants, view applications 📋

  • Authentication: Secure login & registration flow

  • Responsive UI: Mobile-first design with Bootstrap 📱

  • Dynamic Frontend: React Hooks with Vite for fast, efficient rendering ⚡

  • API Integration: Connects seamlessly with backend endpoints 🔗

🛠 Technologies Used

Category Technology
Frontend React.js, Vite, React Hooks
Styling Bootstrap 5, CSS, ReactBootstrap
Routing React Router DOM
HTTP Requests Axios / Fetch API
Icons & UI Font Awesome / React Icons

📂 Project Structure

Recruitment-portal-frontend-react/
│
├── public/             
│
├── src/
│   ├── components/                               
│   ├── pages/           
│   ├── services/        
│   ├── App.jsx          
│   ├── main.jsx         
│   └── styles/          
│
├── package.json         
├── vite.config.js       
└── README.md

🚀 Getting Started

1️⃣ Clone the Repository

git clone <your-repo-url>
cd recruitment-portal

2️⃣ Install Dependencies

Copy code

npm install

3️⃣ Run Development Server

Copy code

npm run dev

4️⃣ Open in Browser

Vite will provide a local URL (default: http://localhost:5173)

💻 Usage

🔑 Login/Register as a job seeker or employer

📝 Job seekers can browse jobs and apply via /dashboard

🏢 Employers can post/manage jobs via /employer-dashboard

📱 Fully responsive design for mobile and desktop

🔗 API Integration

Feature Endpoint Method
Get Jobs /api/jobs GET
Apply for Job /api/applications POST
User Login /api/auth/login POST
User Register /api/auth/register POST
Employer Post Job /api/employer/jobs POST
Fetch Applications /api/employer/applications GET

⚠️ Replace /api/... with your actual backend URLs

🖼 Screenshots

📊 Hireup Homepage

Homepage

🔑 Login Page

Login Page

Register Page

Register Page

📊 Job Seeker Dashboard

Job Seeker Dashboard Job Seeker Dashboard

🏢 Employer Dashboard

Employer Dashboard

Jobseeker Available Jobs

Available jobs

🌟 Future Enhancements

🔔 Real-time notifications for job updates & applications

📄 Resume upload & parsing for job seekers

🌐 Multi-language support

👨‍💻 Crafted by

Shaik Mohammed Hussain

📧 Email: [ mohammedhussainshaik76@gmail.com ]

💼 LinkedIn: Shaik Mohammed Hussain

🐱 GitHub: https://github.com/Hussainshaik-devv

Made with ❤️ using React, Vite, and Bootstrap