Astro Node Express Example

This repo shows an example of how to integrate Astro with an existing Express website.

This will help you when you have an existing Express Website and whant to migrate it to Astro. Astro does not need Express.

Reference: https://docs.astro.build/en/guides/integrations-guide/node/

Follow the commits to see the progress.

1 Create express application

npx express-generator astro-node-express
cd astro-node-express
npm install
npm install nodemon -D

2 Add Astro

npm install @astrojs/node

Create astro.config.mjs with:

import { defineConfig } from 'astro/config'
import node from '@astrojs/node'

export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'middleware',
  }),
})

# this generates /dist folder
npx astro build

3 Add Astro to Express

// app.js
const setupAstroMiddleware = require('./lib/setupAstroMiddleware')

/** Astro pages/middlewares */
setupAstroMiddleware('/', path.join(__dirname, 'dist'), app)

Add package.json scripts:

  "scripts": {
    "start": "npm run astro:build && node ./bin/www",
    "dev": "DEBUG=astro-node-express:* nodemon --exec \"npm run astro:build && node ./bin/www\" -e js,mjs,cjs,json,astro,ts,tsx --ignore dist/",
    "astro:build": "astro check && astro build --silent"
  },

Todo

• Add Astro initial pages/styles/layout
• Add Astro island examples
• Add Astro hot reload on changes