- Open a terminal window and type
yarn install
- Start up the server by typing
yarn dev
๐จ In this workshop it is best NOT look at the solutions. If you get stuck, see a TC.
Take a look at the /data/top50.js
. It contain data on the top 50 songs streamed on Spotify.
We want to render this on our website.
In order to do this, you will need to
- create a file called
top50.ejs
inviews/pages/
. - add in the
header
andfooter
partials. (look over these files and see what they contain). - create a
get
endpoint for the following path:/top50
. - the function called at this enpoint to use
res.render()
. (you can write your function directly inside ofserver.js
) - pass the title to the page: "Top 50 Songs Streamed on Spotify" via the render method.
- It would be good if our title was where the word "Workshop" is at the moment, as well as in the
<head>
of the page as a<title>
. - Pass those values to the partials via the render method.
Once you've completed 1.1, you should have something like this.
Time to add some data to the page.
- We are requiring the
top50
file at the top ofserver.js
. You have access to the file in there. - Pass the array to the
top50.ejs
. - Render the list on the page (only the rank and title for now).
- This data is a list. Make sure to use the proper HTML tags. ๐
Once you've completed 1.1 and 1.2, you should have something like this.
It is better practice to split our code into partials that have only one job to do.
- Move the rendering of the
<li>
for the song to its own file in/views/partials
call itsong.ejs
. - Once you've done that, you can add more song data to the page. Add the rest of the data provided. (
rank
,title
,artist
,streams
,publicationDate
).
Time to style the <li>
s to be a little more readable / presentable.
- we have upgraded to
scss
, fromcss
. - Look inside the
scss
folder. There is already a_song.scss
file in there. It is being imported intostyles.scss
and then compiled into thepublic/css/styles.css
. **Do not modify anythingpublic
. - Write your css in
_song.scss
. Save and reload the page sporadically to check on your progress. You should have something like this below.
- Create a new endpoint
/top50/popular-artist
- create a function that will render the songs of the most popular artist on the list.
- pass only those songs to the
ejs
page. - reuse the song partial to render the songs.
It would be great if each song could have its own page. How do you feel about creating 50 endpoints in server.js
?
You would start with /top50/song/1
and end with top50/song/50
...
No! We ain't doing that, but I would still like to be able to access each individual song that way...
- Create one endpoint using a url parameter in your endpoint
- Page title should be "Song #"
- Create a box like in the screenshot below.
- Use
_song-page.scss
for your styling.
Try navigating to a url for a song that is ranked above 50, below 1. What happens? Our server borks and can't serve a page that doesn't exist.
- fix that.
Once fixed, it should show us the 404 page instead of breaking.
- Add arrows, buttons, or anything you like to the individual song pages that enable user to quickly navigate the list. e.g. If I am on song rank #22, clicking 'next' will take me to song rank #23, etc.
๐ก - Minimally complete workshop (75%) - ๐ก
Take a look at data/books.js
. There is a list of books in there. Using this list, add the following functionality to the server:
- There is a page where I can view ALL of the books.
- I am able to provide the id of a book to view its details (web page)
- This page should include all of the information on the book
- be presented in a legible way (include the cover as well)
- I am able to get a list of books by their type.
- Provide the title, author and smaller version cover
- It should look more like a list.
- No need to add the description.
Don't forget to import the books array into server.js
. Look at how top50 was required
.
๐ข - Complete workshop (100%) - ๐ข
Outside of this project, somewhere else on your computer,
- create a folder
- open it with VS Code
- and setup your very own server.
Look at yesterday's notes if you are not sure.
Also feel free to look at the servers you worked with yesterday and today.
Once you have a working server,
- create some endpoints just to confirm that it's actually up and running.