README
¶
Smallweb - Host websites from your internet folder
Smallweb is a lightweight web server based on Deno. It is inspired both by CGI and online platforms like Val Town and Deno Deploy.
Smallweb maps each folder in ~/www to a subdomain: ~/www/example will be mapped https://example.localhost on your local device, and https://example.<your-domain> on your homelab / VPS.
Each http request is isolated in it's own deno subprocess, meaning that if there is no activity on your website, no resources will be used on your server. It also scales surprisingly well!
Creating a new website becomes as simple a creating text file and opening the corresponding url. No need to create a Dockerfile, launch a dev server or run an install/build command. Since servers are mapped to text files, you can manage them using standard unix tools like cp, mv or rm
The following snippet is stored at ~/www/demo/http.ts on my raspberrypi 400, and served at https://demo.pomdtr.me. Every update to the file is instantly mirrored.
/** @jsxImportSource npm:preact */
import { render } from "npm:preact-render-to-string";
export default function () {
return new Response(
render(
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta
name="viewport"
content="width=device-width, initial-scale=1.0"
/>
<title>Smallweb - Host websites from your internet folder</title>
<link
href="https://cdnjs.cloudflare.com/ajax/libs/tailwindcss/2.2.19/tailwind.min.css"
rel="stylesheet"
/>
</head>
<body class="bg-white flex items-center justify-center min-h-screen text-black">
<div class="border-4 border-black p-10 text-center">
<h1 class="text-6xl font-extrabold mb-4">Smallweb</h1>
<p class="text-2xl mb-6">Host websites from your internet folder</p>
<a
href="https://github.com/pomdtr/smallweb"
class="px-8 py-3 bg-black text-white font-bold border-4 border-black hover:bg-white hover:text-black transition duration-300"
>
Get Started
</a>
</div>
</body>
</html>,
),
{
headers: {
"Content-Type": "text/html",
},
},
);
}
You can install/run smallweb in a few minutes by following the getting started guide.
Documentation
¶
There is no documentation for this package.
Source Files
Directories