onja-org / github-jobs

Final semester project

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Github Jobs

Here we are, the last graded project of this semester.

Your challenge: Create a job search using an API, and use React to handle the frontend. Don’t look at the existing solution. Fulfill user stories below:

image image image

  • User story: I can see a list of jobs in a city by default
  • User story: I can search for jobs with a given keyword
  • User story: I can search for jobs with a city name, zip code or other location
  • User story: I can select one option from at least 4 pre-defined options
  • User story: I can search for a full-time job only
  • User story: I can see a list of jobs with their logo, company name, location, and posted time.
  • User story: When I select a job, I can see job descriptions and how to apply like the given design.
  • User story: When I am on the job details page, I can go back to the search page
  • User story (optional): I can see a list of jobs in the closest city from my location by default
  • User story (optional): I can see jobs in different pages, 5 items each page

You’ll also have to apply a few concept we learned in class, such as a reducer and a global context. And there will be a bonus for those who can find a use case for a compound component.

Icon: https://google.github.io/material-design-icons/ (you can also use the react-icons package)

API: https://jobs.github.com/api. Use data from the API to create questions and answers.

If you get some CORS errors, you can use https://cors-anywhere.herokuapp.com/ to help with accessing data from other websites that are normally forbidden by the same-origin policy of web browsers

Design : https://www.figma.com/file/gAkVx9CdOqnJcCjJ7nVNkw

Live app : https://jolly-heisenberg-20c49e.netlify.app/

Once you completed, polish a nice readme submit your solutions on this link : https://forms.gle/Xg6kJMKmrBkyTe3TA, by providing URLs for both GitHub repository and live app on Netlify.

For the custom domain url you'll enter in netlify, please use the following naming convention : github-jobs-YOUR_FIRSTNAME.netlify.app (replace YOUR_FIRSTNAME by your firstname)

Good luck everybody!

Template for your readme :

{Your project name}

Table of Contents

Overview

screenshot

Introduce your projects by taking a screenshot or a gif. Try to tell visitors a story about your project by answering:

  • Where can I see your demo?
  • What was your experience?
  • In a few sentences, explain the structure of your project.
  • If you had more time, what area of your project would you improve?
  • Did you learn anything new while working on this project?
  • What was the most challenging part for you?
  • Any other comments?

Built With

Features

How To Use

To clone and run this application, you'll need Git and Node.js (which comes with npm) installed on your computer. From your command line:

# Clone this repository
$ git clone https://github.com/your-user-name/your-project-name

# Install dependencies
$ npm install

# Run the app
$ npm start

Acknowledgements

Contact

About

Final semester project