Getting Started

Turn a SvelteKit app into a single standalone executable in a few minutes.

1. Install

bun add -d @orochibraru/svelte-smol

2. Configure the adapter

// svelte.config.js
import adapter from "@orochibraru/svelte-smol";

export default {
  kit: {
    adapter: adapter(),
  },
};

See Adapter options for everything adapter() accepts.

3. Build under Bun

The compile step calls Bun.build, so the build must run on the Bun runtime, not Node. Either force it per command:

bun --bun vite build

or once for the project with a bunfig.toml, after which a plain bun run build works:

[run]
bun = true

Loading the config alone works under Node, so svelte-check, the Svelte language server and svelte-kit sync are unaffected.

4. Run it

build/
├── server        # the compiled executable
├── healthcheck   # tiny probe binary, see Health check
├── client/       # static assets, served by the executable
└── prerendered/  # prerendered pages, served by the executable

./build/server

The executable finds client/ and prerendered/ relative to its own path, so it runs from any working directory. It listens on 0.0.0.0:3000 by default — see Environment variables to change that.

What's supported

WebSockets, read() from $app/server, prerendering, Server-Sent Events and server instrumentation (instrumentation.server.ts) all work. The one thing a compiled binary can't embed is a native (.node) addon — see Native addons.