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