Creating Consistent Website Layouts using Express and Contentstack

Many websites have a common layout that provides a consistent user interface as users navigate from one page to another. This layout usually includes elements such as the site header, navigation, and footer.

This leads to a common notion, especially with ones who have worked with traditional content management systems, that everything appearing on a page is required to be fetched from an entry, with references to common UI elements.

In this document, we'll discuss how we can create a consistent website layout using Express and Contentstack.

Prerequisites

Set up the Essentials

First, create a stack. For this example, we have created sample content types. You just need to download them from our GitHub page. 

After downloading the content types, add entries to it, add a publishing environment and publish the entries

Once you have these configured, you're ready to move on to download the code.

Download Sample Code

We have created an example app. Download it from GitHub. Once you have downloaded the code, open it in any code development tool, it should look similar to the following:

image4.png

Below we list some of the important files and their respective explanation.

  • App.js: It is one of the most crucial files in the code as it's the server file where we add all our website routes (pages), such as Home, About, Blog, and so on.

    code sructure.png

  • partials.js: This file is inside the middleware folder. It has a function that loads our header & footer data used in the routes (res.render) as a variable to render the header and footer with those variables (as used in nunjucks templating).
  • Index.html: In the index.html file, we have included our header and footer. It is the default file that is loaded when we load our pages/routes. 
  • Views: The views folder holds the templates for different pages in our case Home, Blog, Header, and Footer.

So, whenever the Home page route is hit, the header and footer will be rendered. The data will be fetched every time the route is hit. You can add more routes such as Products, Blogs, etc and the header and footer will be shown on each page.

Make Configuration Changes

Once you have downloaded the code, open the config.env and add your stack details to it. You'll also need to enter the content type and entry UIDs respectively as shown below:

image3.png

Start the App

  1. Open the command prompt and move inside your project's root folder. Then, install the node modules by running the following commands:
    npm install
  2. Start the app by running the below command:
    node app.js

By default, the app will start on port 3000. An example is shown below:

image1.png

On This Page

top-arrow