Since beer is one of the most consumed drinks between Ironhackers π» , our mission here is to create an app to showcase some of the best-handcrafted beers, but not just that - to save some as well so the rest of Ironhack community is informed π. Our end goal is creating something like this:
- Fork this repo
- Clone this repo
$ cd lab-react-ironbeers
$ npm install
$ npm start
-
Upon completion, run the following commands:
git add . git commit -m "done" git push origin master
-
Create Pull Request so that your TAs can check up your work.
We will be building a React app so the API (server) needs to be built somewhere for us, right? You are completely right, it's deployed on heroku and the root fo the API is:
https://ih-beers-api2.herokuapp.com/beers
.
The available endpoints are the following:
Method | Endpoint | Response (200) | Action |
---|---|---|---|
GET | / | [beers] | Get all the beers from the DB |
GET | /:id | { beer } | Get the a single/specific beer |
GET | /random | { beer } | Get a random beer from the DB |
POST | /new | { message: "New beer successfully saved to database!"} | Create a new beer (the fields are specified in the instructions) |
GET | /search?q={query} |
[beers] | Get beers from the DB whose name contains the search term. For example /search?q=lager searches for all beers with lager in the name. |
On each iteration, we will explain which endpoint you should use!
The IronBeers project will include the following features:
- A Home page with three different options:
- All Beers
- Random Beer
- New Beer
- A List Beers page where you should display all the beers
- A Single Beer page to display the details of the beer the user clicked on
- A Random Beer page to display a Random Beer
- A New Beer page to show a form where a user can create new beers
β At the very beginning we will offer you to shoot for the stars: as a bonus focus on mobile first design! As we said this is bonus, so it's up to you. π
Create a Home Page. This view should include three links to separate pages:
/beers
/random-beer
/new-beer
Feel free to design it however you wish, but in case you want to do it the way we did it, you can find the following images in src/assets
folder:
On every view (except for the home
), we should add a header with a link
to the root of the app
.
On the /beers
route, we should display all the beers from the database. So, in this case, you need to "hit" the API's route https://ih-beers-api2.herokuapp.com/beers
and the API will return an array of beers.
Hint: The array of beers is array of objects. We strongly advise you to console log the response from the API so you can see the structure of it.
You should display the following from each of the beers:
image
name
tagline
contributed_by
- Also, add the link to check the details of each beer. The link should navigate to
/beers/:beerId
.
When a user click on one of the beers, you should display a detailed view of it, including the following fields:
image
name
tagline
first_brewed
attenuation_level
description
contributed_by
Again, we strongly recommend to console log the response from the API.
On the /random-beer
route, we will render a single beer that will be retrieved from the database. The endpoint will do all the job for us, all we need to do is to call https://ih-beers-api2.herokuapp.com/beers/random
. We should receive an object including all the info about a beer.
The same way we did with the Single Beer view, we should render the following fields:
image
name
tagline
first_brewed
attenuation_level
description
contributed_by
Finally, on the /new-beer
route (remember, this is you react route, you're displaying the form on this route), we should render a form where user can create new beers. The form
should include the following fields:
- name - must be type text
- tagline - must be type text
- description - must be type text
- first_brewed - must be type text
- brewers_tips - must be type text
- attenuation_level - must be type number !!!
- contributed_by - must be type text
Why we pointed out the type? Well, since we already console log response from the API, we could notice that all the fields are strings but attenuation_level, which is number. Using our knowledge from module II, we can make conclusion that in the beer model all the properties are type String except attenuation_level, which is type Number.
When you have built the form, you should do a POST
request to https://ih-beers-api2.herokuapp.com/beers/new
, passing all the data on the body
object. If everything went ok, you would receive a 200 response from the server.
Notice that the fields on the body
should have those specific names so the API can create a new beer.
What could go wrong?: You inputted string instead of number in the attenuation_level field and the server sent you 500 error. Since we didn't cover how to upload images yet, don't worry about it now - the API will assign a random image to the new beer. πΊ
Yes! One endpoint left! On the /beers
route, add an input
where users can search for beers. Every time a new letter is typed, you should call to https://ih-beers-api2.herokuapp.com/beers/search?q={query}
passing the value of the input in the q
param.
We are done! π
Awesome! Grab a beer (if you're not underage π )! Now you are a React Warrior, keep training to become the Ninja!
Happy coding! β€οΈ