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:

. I deleted node_bundler = "esbuild" because it threw an ESM error and everything worked fine regardless.

• 
  

  The package.json can look like this:
  
  

  
  
  CODE Kopieren

   "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:

• 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

  ] 

• 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

• Console.log statements outside of router endpoints are not shown on the console.