How to deploy a Node.js Express app on Netlify (2024)

sakispal

Sakis Pal

Posted on November 9, 2024

How to deploy a Node.js Express app on Netlify (2024)

Netlify does not make it easy to host an Express web app. I hope you will find this guide useful.

Steps

  • Structure your app in a similar way as the below:

Image description

  • Follow this guide https://docs.netlify.com/frameworks/express/ . I deleted node_bundler = "esbuild" because it threw an ESM error and everything worked fine regardless.
  • When creating the netlify.toml file keep redirects specific to the API and any endpoints you want to serve through Express. A general redirect (i.e. "/*") will mess up your CDN and static file serving.

Image description

  • (Optional) Use a local server file for development to keep things more tidy such as the image:

Image description

  • The package.json can look like this:

     "scripts": {
        "start": "node ./functions/server.js",
        "build": "netlify deploy --prod",
        "build-dev": "NODE_ENV=development webpack --mode development --watch",
        "dev": "NODE_ENV=development node server-local.js",
        "dev-watch": "NODE_ENV=development nodemon --exec node server-local.js",
    },
    
  • Write your server.mjs code such as the image:

Image description

  • Inside the index.html and the rest of the .html files the path to CSS, JS, and other assets is best set to the CDN which will work in both dev and production i.e.:

<link rel="stylesheet" href="https://my-app.netlify.app/css/styles.css">

  • Run netlify dev on the console to test before deployment

Key lessons

  • The server.js or server.mjs app only has access to /netlify/functions. The 'public' or 'dist' or 'static' folder will not be added to the netlify folder unless explicitly specified in the netlify.toml file using the command
[functions]
  included_files = [
    "static/views/**"  # Include all files in static/views for server-side access
  ] 
Enter fullscreen mode Exit fullscreen mode
  • Static assets are better served by Netlify's CDN, which will happen automatically if in the netlify.toml file you use the command
[build]
  publish = "static"  # Static assets to be served by Netlify's CDN. Folder defaults to public
Enter fullscreen mode Exit fullscreen mode
  • Console.log statements outside of router endpoints are not shown on the console.
💖 💪 🙅 🚩
sakispal
Sakis Pal

Posted on November 9, 2024

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related