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
23 changes: 23 additions & 0 deletions challenge-baby-name-picker/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.

# dependencies
/node_modules
/.pnp
.pnp.js

# testing
/coverage

# production
/build

# misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local

npm-debug.log*
yarn-debug.log*
yarn-error.log*
6 changes: 6 additions & 0 deletions challenge-baby-name-picker/.vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"cSpell.ignoreWords": [
"favourite",
"favourites"
]
}
137 changes: 38 additions & 99 deletions challenge-baby-name-picker/README.md
Original file line number Diff line number Diff line change
@@ -1,131 +1,70 @@
# Challenge: "Baby Name Picker (React)"
# Getting Started with Create React App

![Example Screenshot from the finished challenge](./example-screenshots/finished.png)
This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).

## Challenge Overview
## Available Scripts

Make a React app which shows some baby names and lets you pick your favourites. The names data is provided for you.
In the project directory, you can run:

## Difficulty Level
### `npm start`

This is a beginner challenge. Level one can be completed by any student who has done week 1 of the CYF React module.
Runs the app in the development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in the browser.

The later levels are suitable from students who have completed at least week 2 of the CYF React module.
The page will reload if you make edits.\
You will also see any lint errors in the console.

## Pre-requisites - what do I need to know to finish this challenge?
### `npm test`

(Level 1)
Launches the test runner in the interactive watch mode.\
See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.

- React `props`
- The `array.map` method and its use in React JSX
### `npm run build`

(Later levels)
Builds the app for production to the `build` folder.\
It correctly bundles React in production mode and optimizes the build for the best performance.

- Event handlers: onClick for buttons
- Event handlers: onChange for input fields
- The `useState` hook
The build is minified and the filenames include the hashes.\
Your app is ready to be deployed!

## Getting Started
See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.

**Don't** clone this repo.
### `npm run eject`

Make your own React app using `create-react-app`. See [(this guide)](https://docs.codeyourfuture.io/students/guides/creating-a-react-app) if you have forgotten how.
**Note: this is a one-way operation. Once you `eject`, you can’t go back!**

Copy across the names file (or its contents) from this repo to your app, and then import from that file.
If you aren’t satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.

Write a plain HTML prototype (e.g. on codepen). THEN, once you know the HTML you're attempting to create, work on the React version! This is not mandatory but it is recommended.
Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.

### The data:
You don’t have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.

The data is available in the file [./babyNamesData.json](./babyNamesData.json).
## Learn More

Copy across this file to your src/ directory, and then import it.
You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).

## GitHub & Hosting:
To learn React, check out the [React documentation](https://reactjs.org/).

Add your project in github and host it on Netlify.
### Code Splitting

The github repo name should be exactly:
`baby-names-react`
This section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)

The netlify site suffix should be `-baby-names`
### Analyzing the Bundle Size

so...
This section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)

`cyf-YOURGITHUBUSERNAME-baby-names`
### Making a Progressive Web App

# Level 1 Challenge
This section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)

* Write a react app which lists baby names from the given file.
### Advanced Configuration

* It should display boys' and girls' names differently - your choice*
This section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)

* The names should be displayed in alphabetical order, ascending.
### Deployment

* Your project should be on GitHub and Netlify with correct names (see Hosting, above).
This section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)

(*) Please, please feel free to break from the the "blue-for-boys/pink-for-girls" stereotyping and style it differently. The best creative solution will be included in this challenge document for subsequent cohorts to admire.
### `npm run build` fails to minify

### Example Screenshot

![Level 1 Example Screenshot](./example-screenshots/level-1.png)

# Level 2 challenge

* Add a search bar.

* When someone types into it, your app should update the displayed list of baby names to only show matches.

* Matches should be case-insensitive.

* When the search bar is clear, all names should be shown.

### Example Screenshot

![Level 2 Example Screenshot](./example-screenshots/level-2.png)

# Level 3 challenge

* Add "favourites".

* When the user clicks a name from the main list, it should be moved to a "favourites" list, displayed separately.
It should disappear from the main list!

* When the user clicks a name from the _favourites_ list, it should be moved back to the main list. It should disappear from the favourites list!

### Example Screenshot

![Level 3 Example Screenshot](./example-screenshots/level-3.png)

# Level 4 challenge

Add "name gender" filter buttons.

Add buttons that allow the user to only see boy or girl names (or all names).

The buttons should operate as "radio" buttons - exactly one should be active at any time.

The app should start by showing all names.

The app should make it clear which filter is in effect.

_How it works with search:_

If there is also a search term in effect, your app should apply any name gender filter to those search results.

### Example Screenshot

![Level 4 Example Screenshot](./example-screenshots/level-4.png)

# Beyond - ideas for more work

- Find a way to persist the favourites even after the browser tab is closed
- Add the ability for the user to shuffle the list of names
- Add the ability for the user to be presented with one or two randomly chosen names.
- Find an attractive way to differentiate names by gender that doesn't use blue/pink stereotypes.

## Further resources

# Credits

This application idea, and look, were taken from [Simon Vrachliotis'](https://simonswiss.com/) app, found via [react.rocks](https://react.rocks/example/Baby_name_inspiration).
This section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)
Loading