Live Demo 👉 Mini Messageboard
Project mini messageboard has been set as part of The Odin Project.
After an introduction to Express and, learning Routes, Controls & views in the Express section of NodeJS course, a project was set to create a mini messageboard.
The lessons on Routes helped me describe how routes are defined, explain route parameters and query parameters and set up new routers on a path.
The lessons on Controllers helped me explore various response methods, implement error handling middleware to catch and process errors gracefully and helped me describe common use cases for middleware, such as validation and authentication.
The views section of this course showed me how to setup EJS in an Express project also how to use EJS.
- none provided
-
Set up a basic Express app by installing Express and EJS. Set up a basic index route and run your server. Create the required folders and files as discussed in the previous lessons.
-
2 routes, the index
("/")
and a “new message” form("/new")
. -
Create an array at the top of your index router called messages and put a couple of sample messages inside of it.
const messages = [
{
text: "Hi there!",
user: "Amando",
added: new Date()
},
{
text: "Hello World!",
user: "Charles",
added: new Date()
}
];
-
Next, in your index template (in the
"views"
folder) loop through the messages array and for each one, display the user, text and the date the message was added. Don’t forget to make your messages available to your template by including it in theres.render
‘locals’ object (e.g.res.render("index", { title: "Mini Messageboard", messages: messages })
). -
Set up the new message form. In the router add a
router.get()
for the"/new"
route and point it to a template named"form"
. In the views directory create yourform
template. Add a heading, 2 inputs (one for the author’s name and one for the message text) and a submit button. To have the form make a network request you will need to define it with both a method and an action like so (we will learn how to handle forms in a later lesson):
<form method="POST" action="/new">
put your inputs and buttons in here!
</form>
- With your form set up like this, when you click on the submit button it should send a POST request to the url specified by the action attribute, so go back to your index router and add a
router.post()
for"/new"
. - In order to get and use the data from your form, you will need to access the contents of your form inside
router.post()
as an object calledreq.body
. The individual fields inside the body object are named according to the name attribute on your inputs (the value of<input name="messageText">
will show up asreq.body.messageText
inside therouter.post
function). For this to work as intended, you’ll need to use a app level Express middleware calledexpress.urlencoded()
to parse the form data into req.body. You can set this up by adding the following line to your app setup:
app.use(express.urlencoded({ extended: true }));
- In your
router.post()
take the contents of the form submission and push them into the messages array as an object that looks something like this:
messages.push({ text: messageText, user: messageUser, added: new Date() });
- At the end of the
router.post()
function useres.redirect("/")
to send users back to the index page after submitting a new message. - Add an “open” button or link next to every message to open a new page with the message details.
From Lesson Using PostgreSQL I was told to go back to this project and implement it with a PostgreSQL db and pg.
- Deploy a new db on a hosting service you choose, and obtain its connection information. I used railway Postgres
- Create a messages table, populate it with data if you wish. This should be done via a script.
- Add the necessary environment variables, create a pool, and implement the required db functions.
- Styling added
Rozla-Dev 02-09-2024