Svarta

Appearance

On this page

Standalone ​

@svarta/adapter-standalone

This is the default deployment target. It is powered by hono, weighing in at only about 35 kB. Your routes will be bundled and minified into a single file using esbuild.

js
import standaloneAdapter from "@svarta/adapter-standalone";

/**
 * @type {import("@svarta/cli").Config}
 */
const config = {
  packageManager: "pnpm",
  routeFolder: "routes",
  minify: true,
  adapter: standaloneAdapter({
    defaultPort: 7777,
    outputFile: ".output/server.mjs",
    logger: {
      enabled: true,
    },
    // TODO: public serving
    // TODO: deploy
  }),
};

export default config;
import standaloneAdapter from "@svarta/adapter-standalone";

/**
 * @type {import("@svarta/cli").Config}
 */
const config = {
  packageManager: "pnpm",
  routeFolder: "routes",
  minify: true,
  adapter: standaloneAdapter({
    defaultPort: 7777,
    outputFile: ".output/server.mjs",
    logger: {
      enabled: true,
    },
    // TODO: public serving
    // TODO: deploy
  }),
};

export default config;

Using the example above, just run node .output/server.mjs to run the server.

WARNING

Even if the .output folder just contains a single file, you should always deploy the entire folder, as there are no guarantees the output bundle only consists of a single file.

Configuration reference ​

defaultPort ​

The default port to bind to. The HTTP port can be dynamically adjusted using the environment variables SVARTA_PORT or PORT.

runtime ​

  • Default: "node"

The server runtime. Currently, only node is supported.

outputFolder ​

  • Default: ".output"

The output folder to which your server will be bundled & output to. The entry point is called entry.mjs.

logger ​

  • Default: { enabled: true }

If logger.enabled is true, a simple HTTP logger is installed before your routes.

Manual install ​

bash
pnpm i -D @svarta/adapter-standalone hono
pnpm i -D @svarta/adapter-standalone hono
bash
yarn add -D @svarta/adapter-standalone hono
yarn add -D @svarta/adapter-standalone hono
bash
npx i -D @svarta/adapter-standalone hono
npx i -D @svarta/adapter-standalone hono