SvelteKit Exec Adapter

⚠️ Experimental Project: This adapter is currently under active development and testing. Use with caution in production environments.

A SvelteKit adapter that builds your full-stack web application as a single executable binary with zero runtime dependencies.

Unlike static builds that strip away server capabilities, this adapter preserves all server-side features of SvelteKit: SSR, API endpoints, server middleware, server-side authentication, and more.

Why Use This Adapter?

Traditional standalone software approaches lose functionality:

• SPA builds + Rust/Go → Lose SvelteKit's server features (SSR, API routes, etc.)
• Desktop apps → Can't be deployed to the web
• Docker → Requires Docker installation and container management

With this SvelteKit adapter:

• ✅ Full SvelteKit capabilities preserved
• ✅ Single binary, no runtime dependencies
• ✅ Cross-platform executable
• ✅ Runs anywhere: locally or on cloud machines

Perfect For

• Open-source tools users can run without Docker/Node.js
• Commercial software sold as one-time purchase for self-hosting
• Privacy-focused apps prioritizing local data ownership
• Demos for users to try before purchasing
• Portable applications that need to run without installation

Examples: AI chat apps, project management tools, content management systems, web analytics dashboards...

Installation

Requires Bun installed on your machine to build the executable.

npm install sveltekit-exec-adapter

Installing Bun

Bun is required as a build dependency to compile your SvelteKit application into an executable binary.

For Linux and macOS:

1. Open your terminal.
2. Execute the following command to download and run the installation script:

curl -fsSL https://bun.sh/install | bash

3. After the installation, you may need to add Bun to your system's PATH. The installer usually prompts you with instructions on how to do this, which often involves adding a line to your shell's configuration file (e.g., ~/.bashrc, ~/.zshrc).

4. Verify the installation by checking the Bun version:

bun --version

For Windows:

1. Bun officially supports Windows, and the recommended way to install it is via PowerShell.
2. Open PowerShell as an administrator.
3. Execute the following command:

powershell -c "irm bun.sh/install.ps1|iex"

4. Alternatively, you can use scoop if you have it installed:

scoop install bun

5. Verify the installation by checking the Bun version:

bun --version

Note: For specific version installations, refer to the official Bun documentation as the commands may vary slightly depending on the desired version.

Usage

// svelte.config.js
import adapter from "sveltekit-exec-adapter";

export default {
  kit: {
    adapter: adapter({
      binaryName: "my-app",
      // Additional options...
    }),
  },
};

Build your application:

npm run build

Run the generated executable:

./dist/my-app

Your SvelteKit app will run at http://localhost:3000 with full server capabilities.

Configuration Options

The adapter accepts various configuration options including comprehensive asset validation to ensure build reliability and optimize binary size.

Basic Configuration

// svelte.config.js
import adapter from "sveltekit-exec-adapter";

export default {
  kit: {
    adapter: adapter({
      binaryName: "my-app",
      embedStatic: true,
      validation: {
        maxAssetSize: 50 * 1024 * 1024, // 50MB per asset
        maxTotalSize: 500 * 1024 * 1024, // 500MB total
        skip: false, // Enable validation
      },
    }),
  },
};

Asset Validation

The adapter includes built-in asset validation that:

• ✅ Validates file existence and accessibility
• ✅ Enforces size limits to prevent bloated binaries
• ✅ Blocks dangerous file types (.exe, .dll, etc.)
• ✅ Warns about potentially problematic assets
• ✅ Provides detailed validation reports

📖 Read the complete Asset Validation Guide

For complete configuration details, check the detailed documentation.

Deployment

🎁 Bonus: When targeting linux-x64, a Dockerfile is automatically generated, enabling easy deployment with services like Fly.io:

fly launch

Contributing

This project is under active development. Contributions, bug reports, and feature requests are welcome!

License

MIT License - see LICENSE file for details.

Credits

This project is based on the original work by Hugo Duprez. Special thanks for the foundational concepts and initial implementation.