- Access information from an API using a GET request and use it to update the DOM
- Listen for user events and update the DOM in response
In this challenge you'll be building an app for rating ramen. You will be using a local API and building out the frontend for our app.
Use this gif as an example of how the app should work.
- Run
npm install
to install the dependencies. - Run
json-server --watch db.json
to get the backend started - Run
npm install -g live-server
to install live-server globally - Run
live-server
to start the frontend in browser - Write your code in the
index.js
file - As you are writing your code out and completing the deliverables ensure that it works on the DOM and passes the tests by running
npm test
in a new terminal in the same directory
Your base URL for your API will be: http://localhost:3000
The endpoints you may need are:
- GET
/ramens
- GET
/ramens/:id
Feel free to add any additional classes or ids to any elements in the HTML file as you see fit.
As a user, I can:
- See all ramen images in the
div
with the id oframen-menu
. When the page loads, fire a function calleddisplayRamens
that requests the data from the server to get all the ramen objects. Then, display the image for each of the ramen using animg
tag inside the#ramen-menu
div. - Click on an image from the
#ramen-menu
div and fire a callback calledhandleClick
to see all the info about that ramen displayed inside the#ramen-detail
div (where it saysinsert comment here
andinsert rating here
). - Attach a submit even listener to the
new-ramen
form using a function calledaddSubmitListener
. After the submission, create a new ramen and add it to the#ramen-menu
div. The new ramen does not need to persist; in other words, if you refresh the page, it's okay that the new ramen is no longer on the page.
** Attention here **: Your program should have a main() function that invokes displayRamens
and addSubmitListener
after the DOM has fully loaded and start the program logic.
These deliverables are not required to pass the code challenge, but if you have the extra time, or even after the code challenge, they are a great way to stretch your skills.
Note: If you are going to attempt these advanced deliverables, please be sure to have a working commit with all the Core Deliverables first!
As a user, I can:
- See the details for the first ramen as soon as the page loads (without clicking on an image)
- Update the rating and comment for a ramen by submitting a form. Changes should
be reflected on the frontend. No need to persist. You can add this HTML to the
index.html
file to create the edit form:
<form id="edit-ramen">
<h4>Update the Featured Ramen</h4>
<label for="edit-rating">Rating: </label>
<input type="number" name="edit-rating" id="edit-rating" />
<label for="edit-comment">Comment: </label>
<textarea name="edit-comment" id="edit-comment"></textarea>
<input type="submit" value="Update" />
</form>
- Delete a ramen (you can add a "delete" button if you'd like, or use an
existing element to handle the delete action). The ramen should be removed
from the
ramen-menu
div, and should not be displayed in theramen-detail
div. No need to persist.
You'll need these endpoints for the advanced deliverables:
- POST
/ramens
- DELETE
/ramens/:id
- PATCH
/ramens/:id
As a user, I can:
- persist my updates to a ramen's rating and comment. (PATCH request)
- persist new ramens that I create (POST request)
- persist any ramen deletions (DELETE request)