smallweb.live

Introduction

Smallweb cloud will allow you to test out smallweb without buying your own domain. It's strongly inspired by both blot.im, val.town, pico.sh, and dokku.

You will interact with smallweb.live using the openssh cli.

Authentication

Just run ssh [email protected] signup <username>. If no user has own this username yet, you'll be able to claim it by confirming your email.

If you then run ssh <username>@smallweb.live, you'll be greated with the smallweb cli.

$ ssh <username>@smallweb.live
Host websites from your internet folder

Usage:
  smallweb [flags]
  smallweb [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  ...

Usage

You can use any ssh/sftp compatible tool to edit your files (the official recommendation will be mutagen).

Then, just create ~/smallweb/example/main.ts:

export default {
    fetch: (_req: Request) => {
        return new Response("Welcome to Smallweb!");
    },
    run: (_args: string[]) => {
        console.log("Welcome to Smallweb!");
    },
};

The fetch endpoint will be available at example.<user>.smallweb.live.

$ curl https://example.<user>.smallweb.live
Welcome to Smallweb!

The run endpoint will be available at example.<user>@smallweb.live.

$ ssh example.<user>@smallweb.live
Welcome to Smallweb!