{"id":27141586,"url":"https://github.com/ashishjii/jobhunter","last_synced_at":"2025-07-12T13:08:43.438Z","repository":{"id":259605450,"uuid":"875134934","full_name":"AshishJii/JobHunter","owner":"AshishJii","description":"JobHunter 💼 is a full-stack job portal built with React for the frontend and Spring Boot for the backend. It enables users to search for jobs, apply, and manage their profiles. Admins can manage listings and applications, with JWT authentication 🔐 ensuring secure login and registration.","archived":false,"fork":false,"pushed_at":"2024-12-30T06:01:50.000Z","size":8118,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T06:59:56.408Z","etag":null,"topics":["jwt","reactjs","springboot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AshishJii.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-19T07:24:23.000Z","updated_at":"2025-03-27T11:35:30.000Z","dependencies_parsed_at":"2024-10-26T21:31:49.190Z","dependency_job_id":"386653c3-502b-47da-a90a-aa9b01794f2f","html_url":"https://github.com/AshishJii/JobHunter","commit_stats":null,"previous_names":["ashishjii/jobhunter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AshishJii/JobHunter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishJii%2FJobHunter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishJii%2FJobHunter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishJii%2FJobHunter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishJii%2FJobHunter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AshishJii","download_url":"https://codeload.github.com/AshishJii/JobHunter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AshishJii%2FJobHunter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264995664,"owners_count":23695007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jwt","reactjs","springboot"],"created_at":"2025-04-08T07:00:05.378Z","updated_at":"2025-07-12T13:08:43.413Z","avatar_url":"https://github.com/AshishJii.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **JobHunter: Spring Boot + React**\n\n**JobHunter** is a full-stack web application designed as a job portal, offering users the ability to search for jobs, apply to them, and manage their profiles. The platform is divided into two main parts: a **React-based frontend** for the user interface and a **Spring Boot backend** that handles business logic and data management.\n\n### Key Features:\n- **Job Listings**: Browse available job opportunities and filter them by category.\n- **User Profile**: Create and manage a personalized profile with contact details and resume.\n- **Job Application**: Apply to job listings directly through the portal.\n- **Admin Panel**: Admins can manage job listings and view applications.\n- **User Registration \u0026 Authentication**: Secure login and registration with JWT authentication.\n\n---\n\n## **UML Diagram**\n\nBelow is the UML diagram that illustrates the architecture and relationships of the **JobHunter** application:\n\n\u003cimg src=\"./showcase/chatuml-diagram.png\" alt=\"UML Diagram\" width=\"600px\"\u003e\n\n---\n\n## **Screenshots**\n\n#### 1. **Home Page**\n\n\u003cimg src=\"./showcase/home.png\" alt=\"Home Page\" width=\"400px\"\u003e\n\n#### 2. **Login/Registration Page**\n\n\u003cimg src=\"./showcase/login.png\" alt=\"Login Page\" width=\"400px\"\u003e \u003cimg src=\"./showcase/register.png\" alt=\"Registration Page\" width=\"400px\"\u003e\n\n#### 3. **User Pages**\n\n\u003cimg src=\"./showcase/profile.png\" alt=\"Profile Page\" width=\"400px\"\u003e \u003cimg src=\"./showcase/jobs.png\" alt=\"Profile Page\" width=\"400px\"\u003e\n\n#### 4. **Admin Panel**\n\n\u003cimg src=\"./showcase/adminApplications.png\" alt=\"Admin Applications Panel\" width=\"400px\"\u003e \u003cimg src=\"./showcase/adminJobs.png\" alt=\"Admin Jobs Management\" width=\"400px\"\u003e\n\n---\n\n## **Project Structure**\n\n- **Frontend**: React app located in the `/frontend` directory.\n- **Backend**: Spring Boot API located in the `/backend` directory.\n\n---\n\n## **Requirements**\n\nBefore you start setting up the project, ensure that the following software is installed:\n\n- **Java 21+** for running the Spring Boot backend\n- **Node.js 14+** for managing the frontend and React development\n\n---\n\n## **Setup Instructions**\n\n### 1. **Clone the Repository**\n\nClone the repository to your local machine using Git:\n\n```bash\ngit clone https://github.com/AshishJii/JobHunter.git\ncd JobHunter\n```\n\n### 2. **Setting up the Frontend**\n\n#### Install dependencies for React:\n\nNavigate to the `frontend` directory and install the necessary Node.js dependencies:\n\n```bash\ncd frontend\nnpm install\n```\n\n#### Run the React development server:\n\nStart the React development server by running:\n\n```bash\nnpm start\n```\n\nYour React app will be running at [http://localhost:3000](http://localhost:3000).\n\n### 3. **Setting up the Backend**\n\n#### Install dependencies for Spring Boot:\n\nNavigate to the `backend` directory and use Maven to install the required dependencies:\n\n```bash\ncd backend\nmvn clean install\n```\n\n#### **Environment Variables**\n\nOpen the `application.properties` file located [here](./backend/src/main/resources/application.properties) and update your configurations:\n\n```properties\nspring.datasource.url=jdbc:mysql://localhost:3306/\u003cdatabase_name\u003e\nspring.datasource.username=\u003cyour_username\u003e\nspring.datasource.password=\u003cyour_password\u003e\n# create a folder named uploads\nupload.dir=C:/path/to/your/uploads/folder/\n```\n\n#### Run the Spring Boot application:\n\nRun the backend using the following command:\n\n```bash\nmvn spring-boot:run\n```\n\nYour Spring Boot API will be available at [http://localhost:8080](http://localhost:8080).\n\n---\n\n\n\n---\n\n## **API Documentation**\n\nThis project exposes various APIs for managing job listings and applications. The API documentation is automatically generated with **Swagger**.\n\nYou can access the Swagger UI at:\n\n```\nhttp://localhost:8080/swagger-ui/index.html\n```\n\n---\n\n## **Contributing**\n\nWe welcome contributions to improve and expand the functionality of **JobHunter**. If you wish to contribute, follow these steps:\n\n1. Fork the repository to your GitHub account.\n2. Create a new branch for your feature or bugfix.\n3. Commit your changes to that branch.\n4. Push your changes to your fork and create a pull request to the main repository.\n\n---\n\n## **License**\n\nThis project is licensed under the MIT License. For details, see the [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashishjii%2Fjobhunter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashishjii%2Fjobhunter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashishjii%2Fjobhunter/lists"}