Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/curiousitydrives/jobsphere
a nodeJS web app that helps users find job opportunities from several job board platforms based on their resumes
https://github.com/curiousitydrives/jobsphere
ajax axios bootstrap5 ejs-templates expressjs html-css-javascript jwt-authentication mongodb multer nodejs
Last synced: 5 days ago
JSON representation
a nodeJS web app that helps users find job opportunities from several job board platforms based on their resumes
- Host: GitHub
- URL: https://github.com/curiousitydrives/jobsphere
- Owner: curiousityDrives
- License: mit
- Created: 2024-12-07T17:17:14.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-01-06T04:28:36.000Z (about 1 month ago)
- Last Synced: 2025-01-06T05:24:35.258Z (about 1 month ago)
- Topics: ajax, axios, bootstrap5, ejs-templates, expressjs, html-css-javascript, jwt-authentication, mongodb, multer, nodejs
- Language: JavaScript
- Homepage:
- Size: 6.13 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
jobSphere
JobSphere is a web application that helps users find job opportunities based on their resumes. It uses a combination of resume parsing, job scraping from multiple platforms, and MongoDB to store user data and job listings. The application allows users to upload their resumes, extract relevant skills and experience, and automatically generate job recommendations based on their profile.
---
## Features
- **User Authentication:** Users can sign up, log in, and securely store their information.
- **Resume Upload:** Users can upload their resumes, which will be parsed to extract relevant details (skills, experience, etc.).
- **Job Scraping:** Automatically fetch jobs from platforms like Indeed, Glassdoor, and ZipRecruiter using parsed resume data.
- **Job Dashboard:** Displays a list of relevant job opportunities tailored to the user based on their resume.
- **Profile Management:** Users can view and manage their profile information.
- **Responsive Design:** The application is designed to be responsive and works well on various screen sizes.
---
## Screenshots
Landing Page
Sign-Up/Signin Pages
Dashboard with Job Recommendations
Profile Page
Modal for Uploading a Resume
Modal for Deleting Your Account
---
## Technologies Used
- **Frontend:** HTML5, CSS3, Bootstrap, EJS, fetch-API
- **Backend:** Node.js, Express.js
- **Database:** MongoDB
- **Resume Parsing:** Integrated with the Resume Parser API
- **Job Scraping:** Python-based web scraping using the `jobspy` module
- **Authentication:** JSON Web Tokens (JWT), Bcrypt.js for password hashing
- **APIs/ Middleware:** Multer, Axios, Connect-Flash, Cookie-Parser, Express-Session
---
## Project Setup
### Prerequisites
Make sure you have the following installed:
- Node.js (v14 or higher)
- MongoDB (or use a MongoDB cloud service like Atlas)
- Python 3.x (for running the job scraper script)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/curiousityDrives/JobSphere.git
cd jobsphere
```
2. Install Node.js dependencies:
```bash
npm install
```
3. Set up MongoDB:
- If you’re using a local MongoDB instance, make sure MongoDB is running.
- If you prefer to use MongoDB Atlas, update the `mongoose.connect()` URI in `app.js` with your MongoDB Atlas credentials.
4. Add the `jobspy` module and any other necessary Python packages for web scraping.
5. Set up environment variables:
- Create a `.env` file in the root directory and add the following:
```env
JWT_SECRET=your_jwt_secret
API_KEY=your_resume_parser_api_key
```
6. Run the server:
```bash
npm start
```
7. Navigate to `http://localhost:3000` in your browser to access the application.
---
## Usage
### Sign Up & Log In
- Create an account by clicking the "Sign Up" link and filling out the registration form with your username, email, and password.
- After signing up, you can log in using your credentials.
### Upload Resume
- Once logged in, you can upload your resume by navigating to the "Upload Resume" page.
- The resume will be parsed, and relevant job recommendations will be displayed based on the extracted data.
### Job Dashboard
- After uploading your resume, the dashboard will show you a list of job opportunities that match your experience and skills.
- If no jobs are found, you will be prompted to upload a resume.
### Job Posts
- When you click on the any of the jobs on your dashboard, you are redirected to a page where that specific job post's details are displayed, from which you can decide either to apply from the site of the post or directly from the company's site.
- In this page, you can also find information on the company and links to their profile, if available.
### Profile
- The profile page allows you to view and manage your user details. You can edit your username, your password, add a second email, add a phone number, upload another resume, or delete your account.
---
## Future Features
- Enhanced job filtering and sorting based on salary, location, and job type.
- Integrate additional job platforms for more comprehensive job scraping.
- Add the ability for users to save job postings and receive notifications.
- Improve the UI with modern design trends and better responsiveness.
---
## Contributing
Contributions are welcome! If you find any bugs or have ideas for new features, feel free to open an issue or submit a pull request.
### How to Contribute:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/your-feature-name`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature/your-feature-name`).
6. Create a new pull request.
---
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## Acknowledgments
- Thanks to [JobSpy](https://github.com/username/jobspy) for the web scraping module.
- Thanks to [Resume Parser API](https://apilayer.com/marketplace/resume-parser-api) for resume parsing.
---
**Note:** This project is still a work in progress, and many features and improvements are in the pipeline. Feel free to contribute or suggest enhancements!
---
Created and maintained by Natnael Haile.