nsite-clay
Sign in with your key and type into the page. It writes the new HTML to a Blossom server and republishes the Nostr event pointing at it, so the next reader gets a plain static file with your words already in it.
01 Why
Most ways to put a page online end with somebody else holding the page. This one ends with you holding a key.
Your words end up in the HTML. Open the saved file in a text editor and there they are, in markup a person could have typed.
The manifest carries one signature. Who may change the page is a fact about a keypair rather than a row in somebody's user table.
Relays keep the pointer, Blossom servers keep the bytes, the browser does the rest. There is no process to restart at three in the morning.
Each one files a permanent snapshot naming an immutable set of hashes. Blobs deduplicate, so the whole history costs almost nothing.
02 Start
You need Node. The first command makes a folder with the page in it and prints a key, which is the only thing that can ever change the page, so copy it somewhere before you close the terminal.
$ npx nsite-clay init mysite $ npx nsite-clay deploy mysite --sec=nsec1…
The second one prints the address. Open it, press Sign in, and the page saves itself from then on. You come back to the terminal only for changes you would rather make in an editor.
Already have a Nostr key? Hand your npub to init and the
page belongs to you from the first deploy.
$ npx nsite-clay init mysite --npub=npub1…
03 Limits
The manifest carries one signature, so there is no shared editing and no per-visitor content.
A replaceable event has no compare-and-swap. Two devices editing the same page will quietly lose one side's work.
Sub-resources are hash-checked and every event is signature-checked, but the entry document cannot verify itself. Read the same page through a second gateway, or run your own.
If what you are building needs a backend, this is the wrong tool.
04 Docs
The walkthrough is the one to read first. It goes from an empty folder to a published page you can edit, with a screenshot of every step.
05 Writing
Longer pieces about what this is for and how it behaves. They are Nostr long-form posts rather than files on this page, so any Nostr client shows the same text, and a new one turns up here without anybody touching the page.
add #edit to the URL to edit this page