Server Middleware

Use middleware when you already have a server app and want to inject mokup routes. If you just need a dev server with hot reload, use createFetchServer.

Dev server (recommended)

import { createFetchServer, serve } from 'mokup/server/node'

const app = await createFetchServer({ entries: { dir: 'mock' } })
serve({ fetch: app.fetch, port: 3000 })

Middleware integration (build mode)

Use build mode when you want a stable bundle for production.

pnpm

pnpm exec mokup build --dir mock --out .mokup

npm

npm exec mokup build --dir mock --out .mokup

yarn

yarn mokup build --dir mock --out .mokup

bun

bunx mokup build --dir mock --out .mokup

import mokupBundle from './.mokup/mokup.bundle.mjs'

const options = {
  manifest: mokupBundle.manifest,
  moduleMap: mokupBundle.moduleMap,
  moduleBase: mokupBundle.moduleBase,
}

Register the middleware

Express

import express from 'express'
import { createExpressMiddleware } from 'mokup/server/node'

const app = express()
app.use(createExpressMiddleware(options))

Koa

import Koa from 'koa'
import { createKoaMiddleware } from 'mokup/server/node'

const app = new Koa()
app.use(createKoaMiddleware(options))

Fastify

import Fastify from 'fastify'
import { createFastifyPlugin } from 'mokup/server/node'

const app = Fastify()
await app.register(createFastifyPlugin(options))

Hono

import { Hono } from 'hono'
import { createHonoMiddleware } from 'mokup/server/node'

const app = new Hono()
app.use(createHonoMiddleware(options))

See the Server Adapters for more frameworks and options.