Skip to content
blogwright

Nuxt SSR

Copy it into a new project:

Terminal window
pnpm dlx degit antstanley/blogwright/examples/nuxt-ssr my-site

Nuxt 4 with Nitro’s node-server preset, running on a Lambda Web Function. /_nuxt/ assets still serve from S3.

Framework Mode Blogwright config Source
Nuxt 4 (Nitro node-server) Server-rendered ssr examples/nuxt-ssr

Deploy it

Section titled “Deploy it”

  1. Copy the example and start a repository:

    Terminal window
    pnpm dlx degit antstanley/blogwright/examples/nuxt-ssr my-site
    cd my-site && git init

  2. Set siteName and region in config/production.jsonc. For SSR, region must be us-east-1, us-east-2, us-west-2, ap-northeast-1 or eu-west-1.

  3. Add Blogwright, then commit everything, including pnpm-lock.yaml - the builder installs with --frozen-lockfile:

    Terminal window
    pnpm add -D blogwright
    git add -A && git commit -m "Start from the blogwright example"

  4. Create the infrastructure: pnpm exec blogwright bootstrap

  5. Build and publish: pnpm exec blogwright deploy

What matters

Section titled “What matters”
  • nuxt.config.ts - the node-server preset (Nuxt’s default), which writes a standalone server to .output/server with the dependencies it needs copied in as real files.
  • lambda.mjs - the entry shim. It maps AWS_LAMBDA_HTTP_ENDPOINT onto NITRO_HOST and NITRO_PORT, then imports index.mjs. The build copies it into .output/server/.
  • pnpm-workspace.yaml - allowBuilds approves esbuild’s install script. pnpm 11 fails an install that meets an unapproved one, in the builder as much as locally.
  • config/production.jsonc - packages .output/server. staticDir and staticPaths publish /_nuxt/ from .output/public to S3.

The files

Section titled “The files”
config/production.jsonc
// Blogwright config for this example. Paths are relative to the repository
// root, so they assume this directory IS the repository - see README.md.
{
  "region": "us-east-1",
  "siteName": "nuxt-ssr",
  "ssr": {
    "packageDir": ".output/server",
    "entryPoint": "lambda.mjs",
    "staticDir": ".output/public",
    "staticPaths": ["/_nuxt/*", "/favicon.svg"],
  },
}
nuxt.config.ts
export default defineNuxtConfig({
  compatibilityDate: '2026-10-01',
  // The default preset: a standalone Node server in .output/server.
  nitro: { preset: 'node-server' },
  app: {
    head: { link: [{ rel: 'icon', href: '/favicon.svg' }] },
  },
});
lambda.mjs
// Entry shim for Lambda Web Functions. Lambda passes the listen address in
// AWS_LAMBDA_HTTP_ENDPOINT; Nitro's node-server reads NITRO_HOST and NITRO_PORT.
const endpoint = process.env.AWS_LAMBDA_HTTP_ENDPOINT;
const colon = endpoint.lastIndexOf(':');
process.env.NITRO_HOST = endpoint.slice(0, colon);
process.env.NITRO_PORT = endpoint.slice(colon + 1);
await import('./index.mjs');
pnpm-workspace.yaml
# A workspace of its own, so pnpm treats this directory as the project root
# even inside the blogwright repository.
packages:
  - .


allowBuilds:
  # esbuild's postinstall installs its platform binary.
  esbuild: true
package.json
{
  "name": "blogwright-example-nuxt-ssr",
  "private": true,
  "type": "module",
  "packageManager": "pnpm@11.25.0",
  "scripts": {
    "dev": "nuxt dev",
    "build": "nuxt build && cp lambda.mjs .output/server/",
    "postinstall": "nuxt prepare"
  },
  "dependencies": {
    "nuxt": "^4.6.1",
    "vue": "^3.5.0",
    "vue-router": "^4.5.0"
  }
}

Check the package locally

Section titled “Check the package locally”

Run it the way Lambda does - from a copy outside the project, so nothing resolves from its own node_modules:

Terminal window
pnpm build
cp -R .output/server /tmp/pkg && cd /tmp/pkg
AWS_LAMBDA_HTTP_ENDPOINT=127.0.0.1:8080 node lambda.mjs
curl -i http://127.0.0.1:8080/

The server must start listening within 10 seconds, and find .output/server -type l must print nothing: the build agent rejects a package that contains a symbolic link.

Section titled “Related pages”