This repository contains the frontend client for the Placement Portal, a full-stack web application designed to streamline the job placement process. This responsive user interface is built with vanilla JavaScript, HTML, and CSS, and it communicates with a backend REST API to function.
➡️ Backend Repository: placement-portal-backend
You can view the complete, deployed application here: https://hack-2-hired.onrender.com/
- Intuitive Job Board: Clean and easy-to-navigate interface for students to browse job opportunities.
- Secure Login: Interface for JWT-based user authentication.
- Role-Based Views: Dynamically displays different options and views for "Admin" and "Student" roles.
- Admin Dashboard: Provides forms and controls for admins to create and manage job postings.
- Responsive Design: Ensures a seamless experience across desktop and mobile devices.
| Category | Technology / Tool |
|---|---|
| Core | Vanilla JavaScript, HTML5, CSS3 |
| API Client | Fetch API (Browser) |
| Deployment | Render |
To run the frontend client locally, you must have the backend server running first.
- A modern web browser (like Chrome, Firefox).
- A local web server to serve the static files (optional, but recommended to avoid CORS issues). The
Live Serverextension for VS Code is a great option.
-
Clone the repository:
git clone https://github.com/abhi6101/placement-portal-frontend.git cd placement-portal-frontend -
Ensure the Backend is Running: Follow the setup instructions in the backend repository to start the server on
http://localhost:8080. -
Run the Frontend:
- If using the VS Code Live Server extension, right-click on
index.htmland select "Open with Live Server". - Alternatively, you can open the
index.htmlfile directly in your web browser.
- If using the VS Code Live Server extension, right-click on
-
Configure API endpoint (if necessary):
- In the JavaScript files, ensure that all API requests are pointing to
http://localhost:8080. If you need to change this, search for the base URL variable in the code.
- In the JavaScript files, ensure that all API requests are pointing to
Contributions are welcome! If you have suggestions to improve the UI or add features, please feel free to fork the repo and create a pull request.