Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions src/challenges/jobListings/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
# Frontend Mentor - Job Listings Challenge

![Design preview for the Job Listings coding challenge](./design/desktop-preview.jpg)

## Welcome! 👋

Thanks for checking out this front-end coding challenge.

[Frontend Mentor](https://www.frontendmentor.io) challenges allow you to improve your skills in a real-life workflow.

**To do this challenge, you need a basic understanding of HTML, CSS and JavaScript.**

## The challenge

Your challenge is to build out this job listing page and get it looking as close to the design as possible.

You can use any tools you like to help you complete the challenge. So if you've got something you'd like to practice, feel free to give it a go.

Your users should be able to:

- View the optimal layout for the site depending on their device's screen size
- See hover states for all interactive elements on the page
- Filter job listings based on the categories using the HTML `data-` attribute

### Filtering

#### Option 1

Filter job listings based on the categories using the HTML `data-` attribute. In this option, you'd use the hardcoded content that already exists in the [index.html](./index.html) file.

The categories are:

- Role: Frontend, Backend, Fullstack
- Level: Junior, Midweight, Senior
- Languages: Python, Ruby, JavaScript, HTML, CSS
- Tools: React, Sass, Vue, Django, RoR (Ruby on Rails)

So, if a job listing is for has the following categories `Frontend, Junior, JavaScript, React` your HTML data attributes would look like this `data-role="frontend" data-level="junior" data-languages="javascript" data-tools="react"`.

#### Option 2

Use the [data.json](./data.json) file to pull the data and then dynamically add the content. This would be perfect if you're looking to practice a JS library/framework like React, Vue, or Svelte.

To add a filter, the user needs to click on the tablets on the right-side of the listing on desktop or the bottom on mobile. For each filter added, only listings containing all selected filters should be returned.

Want some support on the challenge? [Join our Slack community](https://www.frontendmentor.io/slack) and ask questions in the **#help** channel.

## Where to find everything

Your task is to build out the project to the designs inside the `/design` folder. You will find both a mobile and a desktop version of the design to work to.

The designs are in JPG static format. This will mean that you'll need to use your best judgment for styles such as `font-size`, `padding` and `margin`. This should help train your eye to perceive differences in spacings and sizes.

If you would like the Sketch file in order to inspect the design in more detail it is available to buy from the challenge page on the platform.

You will find all the required assets in the `/images` folder. The assets are already optimized.

There is also a `style-guide.md` file, which contains the information you'll need, such as color palette and fonts.

## Building your project

Feel free to use any workflow that you feel comfortable with. Below is a suggested process, but do not feel like you need to follow these steps:

1. Initialize your project as a public repository on [GitHub](https://github.com/). This will make it easier to share your code with the community if you need some help. If you're not sure how to do this, [have a read through of this Try Git resource](https://try.github.io/).
2. Configure your repository to publish your code to a URL. This will also be useful if you need some help during a challenge as you can share the URL for your project with your repo URL. There are a number of ways to do this, but we recommend using [ZEIT Now](http://bit.ly/fem-zeit). We've got more information about deploying your project with ZEIT below.
3. Look through the designs to start planning out how you'll tackle the project. This step is crucial to help you think ahead for CSS classes that you could create to make reusable styles.
4. Before adding any styles, structure your content with HTML. Writing your HTML first can help focus your attention on creating well-structured content.
5. Write out the base styles for your project, including general content styles, such as `font-family` and `font-size`.
6. Start adding styles to the top of the page and work down. Only move on to the next section once you're happy you've completed the area you're working on.

## Deploying your project

As mentioned above, there are a number of ways to host your project for free. We recommend using [ZEIT Now](http://bit.ly/fem-zeit) as it's an amazing service and extremely simple to get set up with. If you'd like to use ZEIT, here are some steps to follow to get started:

1. [Sign up](http://bit.ly/fem-zeit-signup) to ZEIT Now and go through the onboarding flow, ensuring your GitHub account is connected by using their [ZEIT Now for GitHub](https://zeit.co/docs/v2/git-integrations/zeit-now-for-github) integration.
2. Connect your project to ZEIT Now from the ["Create a new project" page](https://zeit.co/new), using the "New Project From GitHub" button and selecting the project you want to deploy.
3. Once connected, every time you `git push`, ZEIT Now will create a new [deployment](https://zeit.co/docs/v2/platform/deployments) and the deployment URL will be shown on your [ZEIT Dashboard](https://zeit.co/dashboard). You will also receive an email for each deployment with the URL.

## Sharing your solution

There are multiple places you can share your solution:

1. Submit it on the platform so that other users will see your solution on the site. Other users will be able to give you feedback, which could help improve your code for the next project.
2. Share your repository and live URL in the **#finished-projects** channel of the [Slack community](https://www.frontendmentor.io/slack).
3. Tweet [@frontendmentor](https://twitter.com/frontendmentor) and mention **@frontendmentor** including the repo and live URLs in the tweet. We'd love to take a look at what you've built and help share it around.

## Giving feedback

Feedback is always welcome, so if you have any to give on this challenge please email hi[at]frontendmentor[dot]io.

This challenge is completely free. Please share it with anyone who will find it useful for practice.

**Have fun building!** 🚀
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions src/challenges/jobListings/src/components/company-logo.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
const LogoImage = ({ img, company }) => {
return <img src={img} className="" alt={`${company} Logo`}></img>;
};

export default LogoImage;
26 changes: 26 additions & 0 deletions src/challenges/jobListings/src/components/focus-pill.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
const Pill = ({ text }) => {
const pillTypeCss = text === "NEW!" ? "pill-new" : "pill-featured";
const pillClass = `rounded-full ${pillTypeCss}`;
return (
<div className={pillClass}>
<p className="px-2 inline-block">{text}</p>
<style jsx>{`
p {
color: white;
font-weight: bold;
font-size: 8px;
text-align: center;
}

.pill-new {
background-color: var(--Desaturated-Dark-Cyan);
}
.pill-featured {
background-color: black;
}
`}</style>
</div>
);
};

export default Pill;
17 changes: 17 additions & 0 deletions src/challenges/jobListings/src/components/head.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
import Head from "next/head";
const CSSHead = () => {
return (
<>
<Head>
<title>Job Listings - frontendmentor.io</title>
<meta name="viewport" content="initial-scale=1.0, width=device-width" />
<link
href="https://fonts.googleapis.com/css2?family=Spartan:wght@500;700&display=swap"
rel="stylesheet"
></link>
</Head>
</>
);
};

export default CSSHead;
19 changes: 19 additions & 0 deletions src/challenges/jobListings/src/components/job-details.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
const JobDetails = ({ postedAt, contract, location }) => {
return (
<div className="flex content-center">
<p className="pr-4">{postedAt}</p>
<p className="pr-4">•</p>
<p className="pr-4">{contract}</p>
<p className="pr-4">•</p>
<p className="pr-4">{location}</p>
<style jsx>{`
p {
font-size: 12px;
color: var(--Dark-Grayish-Cyan);
}
`}</style>
</div>
);
};

export default JobDetails;
60 changes: 60 additions & 0 deletions src/challenges/jobListings/src/components/job-filters.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
import Tag from "./tag";
import { getImage } from "../../../../services/joblistings/joblistings-api-utils";

const JobFilter = ({ selectedTags, removeTag }) => {
return (
<section className="flex w-full p-8 my-4 shadow-xl">
{selectedTags.map((tag) => {
return (
<JobFilterTagSpacing
text={tag}
backgroundColor="isNotSelected"
removeTag={removeTag}
/>
);
})}
<style jsx>{`
section {
background-color: white;
}
`}</style>
</section>
);
};

const JobFilterTagSpacing = (props) => {
return (
<div className="px-2">
<JobFilterTag {...props} />
</div>
);
};

const JobFilterTag = ({ text, backgroundColor, removeTag }) => {
const removeIcon = getImage("icon-remove.svg");

const removeTagByValue = (e) => {
removeTag(text);
};
return (
<div className="">
<div className="inline-block">
<Tag text={text} backgroundColor={backgroundColor} />
</div>
<div className="filterTagRemove inline-block align-middle h-6 w-6">
<img
src={removeIcon}
alt="remove icon"
onClick={removeTagByValue}
></img>
</div>
<style jsx>{`
.filterTagRemove {
background-color: black;
}
`}</style>
</div>
);
};

export default JobFilter;
58 changes: 58 additions & 0 deletions src/challenges/jobListings/src/components/joblisting-tags.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
import Tag from "./tag";
import { useState } from "react";

const JobListingTags = ({
id,
role,
level,
updateTags,
languages = [],
tools = [],
}) => {
return (
<div className="flex content-center justify-end h-full flex-wrap">
<TagSpacer updateTags={updateTags} text={role}></TagSpacer>
<TagSpacer updateTags={updateTags} text={level}></TagSpacer>
{languages.map((language) => {
return (
<TagSpacer
key={id}
updateTags={updateTags}
text={language}
></TagSpacer>
);
})}
{tools.map((tool) => {
return (
<TagSpacer key={id} updateTags={updateTags} text={tool}></TagSpacer>
);
})}
</div>
);
};

export default JobListingTags;

const TagSpacer = ({ text, updateTags }) => {
const [isSelected, toggle] = useState(false);

const selectTag = (e) => {
toggle(!isSelected);
updateTags(e.currentTarget.innerHTML);
};

const selectionBackgroundColor = isSelected ? "isSelected" : "isNotSelected";
const backgroundColor = `rounded-sm ${selectionBackgroundColor}`;

return (
<div className="px-1">
<div className="text-center p-1">
<Tag
text={text}
updateTags={selectTag}
backgroundColor={backgroundColor}
/>
</div>
</div>
);
};
36 changes: 36 additions & 0 deletions src/challenges/jobListings/src/components/joblisting.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
import { getImage } from "../../../../services/joblistings/joblistings-api-utils";
import LogoImage from "./company-logo";
import JobListingInformation from "./posting-information";
import JobListingTags from "./joblisting-tags";
const JobListing = ({ job, updateTags }) => {
const imgSrc = getImage(job.logo);
return (
<section className="flex w-full my-4 p-8 shadow-xl">
<div className="w-1/12">
<div className="flex flex-wrap">
<LogoImage img={imgSrc} company={job.company} />
</div>
</div>
<div className="w-4/12 pl-4">
<JobListingInformation {...job} />
</div>
<div className="w-7/12 h-full">
<JobListingTags
id={job.id}
role={job.role}
level={job.level}
languages={job.languages}
tools={job.tools}
updateTags={updateTags}
/>
</div>
<style jsx>{`
section {
background-color: white;
}
`}</style>
</section>
);
};

export default JobListing;
Loading