Server

Source: src/Website/Server.ts

The framework toolchain half of a website: on alchemy deploy it runs the framework’s production build with a platform deploy target and tracks the on-disk output in state; on alchemy dev it runs the framework’s OWN dev server (native HMR via the framework’s kit) in the dev sidecar and exposes its local URL. Shared by AWS, Fly, Hetzner, and Railway website composites.

The framework package and the target module are loaded from your project’s node_modules, so your project’s framework version drives the build. Build inputs are content-hashed so an unchanged project skips the rebuild entirely.

Building Frameworks

const server = yield* Server("Server", {
  framework: "@alchemy.run/frontend-frameworks/nuxt",
  target: "@alchemy.run/frontend-frameworks/nuxt/aws",
  root: "./app",
});
// deploy: server.serverEntry -> .output/server/index.mjs (Lambda handler)
//         server.clientDir   -> .output/public (static assets for the CDN)
// dev:    server.url         -> http://localhost:<port> (framework HMR server)