▲ nostr-client

A nostr client built as independent, swappable parts. Vanilla JavaScript, no build step, no bundler, no framework. One repo, one thing — eleven clients, a built-in bitcoin wallet, and a theme system, all from the same components. Everything served from GitHub Pages. AGPL.

Eleven clients, zero builds

Composed clients are just pages that arrange parts — so they come in grades (new here? join nostr in 60 seconds):

Same components, different HTML files. zen's entire "fork" is two CSS custom properties.

It already works — this is live

Principles

• One repo, one thing. A profile editor is a repo. A relay pool is a repo. Each deploys its own live demo on gh-pages, so every part is also a working page.
• No build, ever. Browsers run ES modules natively. What's in the repo is what runs. view-source: is the docs.
• Hex is the primitive. APIs, attributes, events and storage speak 64-char hex pubkeys and event ids. npub…/nsec… are presentation only (nip19), and a key is also a W3C identifier: did:nostr.
• Compose through contracts, not frameworks. Parts meet at tiny interfaces — a NIP-07-shaped signer, a shared relay pool, DOM events. Use them from plain HTML, preact/htm, or anything else.
• Swap anything. Every part defaults to the shared implementations but accepts replacements: another signer, another pool, another login. Change one URL, keep the rest.
• One key: identity + money. A nostr pubkey is a BIP-340 x-only key — so it's also a taproot bitcoin address. Anyone can tip your npub; your nsec spends it. No zap servers, no custodians, testnet-first.

The parts

Quick start

A working nostr page, from nothing, no toolchain:

<script type="module" src="https://nostr-client.github.io/login/login.js"></script>
<script type="module" src="https://nostr-client.github.io/feed/feed.js"></script>
<script type="module" src="https://nostr-client.github.io/composer/composer.js"></script>

<nostr-login></nostr-login>
<nostr-composer></nostr-composer>
<nostr-feed limit="20"></nostr-feed>

The contract

Parts interoperate through five small conventions — see CONTRACT.md:

1. hex is the primitive          64-char hex pubkeys/ids everywhere; NIP-19 is display-only
2. the signer                    window.nostrSigner = { type, getPublicKey(), signEvent(evt) }
                                 announced via 'nostr:login' / 'nostr:logout' on window
3. the pool                      defaultPool() — one websocket per relay per page,
                                 however many components you compose
4. events                        components emit bubbling 'nostr:*' CustomEvents
5. swapping                      absolute-URL ES module imports — override any of them
                                 with an import map, or inject .pool / .signer properties

Identity

This org itself has a nostr identity: agent.did.json — a did:nostr document, because a nostr public key is already a W3C-resolvable identifier.