Serve 🍛

Ultralight http server with live reload.
_{CLI + API}

Simple CLI and API

With live reload

Light and modern

With secure protocol

With SPA support

No dependencies

One command

npm init serve

Or one function

import serve from 'create-serve';

serve.start();

To start 🍛

CLI

By default, it serves public if the folder exists, otherwise root /.
Or you can specify a different folder.

npm init serve [folder]

API

import serve from 'create-serve';

serve.start({
    host: 'localhost',
    port: 7000,
    root: '.',
    live: true,
    fallback: 'index.html',
    isHttps: true,
    tlsOptions: {
      key: 'absolute path to private key',
      cert: 'absolute path to cert',
    },
});

Live reload

serve.update();

Use any file watcher

Chokidar

import serve from 'create-serve';
import chokidar from 'chokidar';

serve.start();

chokidar.watch('.').on('change', () => {
    serve.update();
});

esbuild

Use the official wrapper for esbuild's watch   →   esbuild-serve

Log

Import the util functions to log updates with colours.

import serve, { error, log } from 'create-serve';

serve.update();

hasError
    ? error('× Failed') // Red
    : log('✓ Updated'); // Green