Nostr Components is a free, open-source toolkit that lets website owners place Nostr content directly on their pages. It is aimed at webmasters, bloggers and developers who want a follow button, a profile badge or a zap button on a site without building the Nostr integration from scratch. The code is written in JavaScript and TypeScript and released under the MIT license.
The project is best understood as a web component library rather than a conventional Windows program. Its documentation mentions Windows, but the catalog has not verified Windows support, so treat it as a browser-based tool you test on your own Windows PC. Interactive buttons also need a Nostr signer in the visitor's browser, which is covered in the sections below.
What Is Nostr Components and Why Embed It?
Nostr is an open protocol where identities are cryptographic keys and content is published through relays rather than a single company's servers. Most Nostr activity happens in dedicated apps, which means a website visitor rarely sees it. Embedding brings that activity into a normal web page.
The project is inspired by fiatjaf's Nostr Web Components, but it adds a more polished user interface and makes it possible to embed Nostr content almost anywhere on the internet. A small publishing site might show a host's recent Nostr posts beside an episode, or a project homepage might let visitors follow the team's account in one click.
Embedding also keeps visitors on your domain. They do not need to leave your site to see a profile or follow an account, which can make Nostr feel less like a separate destination and more like a natural extension of what you publish.
Who Is Nostr Components For?
The primary audience is webmasters who manage their own sites and want to add Nostr features without a large development budget. A blogger can add a profile badge to the author bio, while a community site can place a follow button on its homepage so readers can connect with the account.
Developers prototyping Nostr features may also find the component approach useful. Because each element is self-contained, you can test one widget on a staging page before adding several to a production site.
The kit is less suited to people who only want a full Nostr experience for themselves. If your goal is to read feeds and manage your own account, a dedicated app will serve you better than a set of website elements.
How Web Components Make Embedding Simpler
Web components are reusable custom HTML elements that package their own structure and behavior. You place a tag where you want a widget to appear, and the component handles the rest. This approach works across many site builders and frameworks, which is why it fits a wide range of Nostr embeds.
The components are designed to keep page loading lighter. The script that connects to a browser signer loads only when a visitor first interacts with a button, so a page with a profile badge alone does not need to pay that cost up front.
For site owners, the practical result is that adding Nostr content feels closer to inserting an image or a video than to building an integration. You still need to check layout, styling and sign-in behavior on your own pages, but the core work is configuration rather than custom coding.
Key features
Follow Button
Profile Badge
Zap Button
WordPress Integration
Storybook Component Generator
Supported coins
Nostr is the network these components are built around, and the documentation names it as the only network involved. The zap button is the one payment-style action in the set, and it works as a tip within the Nostr ecosystem rather than as a wallet feature.
How to install Nostr Components on Windows
- 1
Get the Source From the Official Repository
Open the project's GitHub repository at github.com/saiy2k/nostr-components. Download only from the official GitHub repository or its Releases page, and avoid copies hosted on other sites.
- 2
Check the Release Notes and Checksum
Read the release notes before you use the files. If the release page publishes a SHA-256 checksum or signature, verify the download against it before you proceed.
- 3
Add the Components to Your Site
Follow the README instructions to include the component script in your HTML or theme. Then place the element tags where you want each widget to appear. WordPress users should follow the WordPress integration path described in the documentation.
-
Test With a Nostr Signer
Open the page in a browser that has a Nostr signing extension installed. Click a follow or zap button and confirm that the sign-in prompt appears as expected before you publish the page.
System requirements
- A modern web browser on Windows; the project documentation mentions Windows, but the catalog has not verified it
- A Nostr-compatible browser extension that provides window.nostr for interactive buttons such as follow and zap
- A website or WordPress site where you can add HTML or theme code
How to use Nostr Components
Once the components are in place, the work is mostly configuration and testing. Here is a practical sequence for a webmaster adding a follow button to a page.
- Choose the Nostr account you want visitors to follow and copy its public identifier from your Nostr client.
- Open the page template or HTML file where the component will live.
- Insert the follow button element and set the account identifier as described in the project documentation.
- Preview the page locally in a Windows browser to check layout, spacing and button placement.
- Open the page in a separate browser profile without a Nostr extension and confirm the button asks for a signer rather than failing silently.
- Install a Nostr signing extension in your normal browser, click the button, and confirm the prompt shows the action you expect.
- Publish the page and review it on mobile and desktop screens.
Repeat the test after each update to the component or your theme, since small layout changes can affect how a button looks next to other content.
Pros & cons
- Free and open source under the MIT license
- Brings Nostr actions such as follow and zap onto ordinary web pages
- Includes a WordPress integration path for blog owners
- Storybook generator helps webmasters preview components before publishing
- Interactive components load their signer script only when needed
- Not a standalone Windows application, so you need a website to use it
- Windows support has not been verified by the catalog
- Interactive buttons need a Nostr signer in the visitor's browser
- Embedding requires basic comfort with HTML or a CMS plugin setup
Is Nostr Components safe?
Download the code only from the project's official GitHub repository or its Releases page, never from mirrors or repackaged bundles. If a release includes a SHA-256 checksum or signature, verify it before using the files, and treat any mismatch as a reason not to use them. Because these components ask visitors to authenticate with a Nostr signer, never enter a seed phrase or private key into a third-party site or a pop-up that is not from your browser extension. A genuine signing prompt should describe a specific action you can review. Before installing, check the latest version on the official website, since release details can change between updates.
- Official source only. Download from github.com/saiy2k/nostr-components. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Nostr Components is not a Nostr client. Amethyst and Gossip are apps where you read feeds, post and manage your own account, and Gossip is a desktop client built in Rust. NAK is a command-line tool for working with Nostr events from a terminal. Vega is a cross-platform desktop client that also centers on using Nostr directly.
Nostr Components takes a different approach. It places Nostr actions such as following, profile display and zapping onto a website your visitors already browse. If you want to read or publish yourself, a client or command-line tool fits better. If you want visitors to engage with Nostr from your own domain, this kit is the relevant category.
Specifications
- Price
- Free
- Type
- Open source
- License
- MIT
- Latest version
- —
- Last update
- 21 Oct 2026
- Windows support
- Unverified (Windows mentioned in docs)
- Source code
- github.com/saiy2k/nostr-components
Frequently asked questions
Yes. Nostr Components is free and released under the MIT license, which sets the terms for using, modifying and distributing the code. Because it is open source, you can read the source on GitHub before deciding to use it. The license is the main condition attached to the project.
The project documentation mentions Windows, but the catalog has not verified Windows support. It is a web component library, so it runs inside a browser rather than as a standalone Windows program. You can build and test your pages on a Windows PC, and the results depend on your browser and setup.
It is open source, and its code is public on GitHub, so developers can review it. Safety depends mainly on where you download it and how you respond to signing prompts. Use only the official repository, check any published checksum, and never enter a seed phrase on a third-party page.
Yes, interactive components such as the follow and zap buttons require the visitor to authenticate. Visitors need a Nostr identity and a browser signer that can approve the action. Read-only elements such as profile badges work differently, so test each component on your own page.
Yes. The project lists WordPress integration as a feature, so blog owners can add Nostr elements to WordPress pages without building components by hand. Check the documentation for setup steps that match your WordPress version and theme. Test the result on a staging copy before changing a live site.
It is a visual tool for webmasters that lets them preview components in isolation before placing them on a live page. You can check appearance and layout without deploying to your site. Developers can use the same view to review how each component looks before they publish changes.
Verdict
Nostr Components suits webmasters and developers who want to add Nostr follow buttons, profile badges, zap buttons or posts to a website. It is free, MIT-licensed and easy to try on a test page. It is not a good fit for someone looking for a Nostr app to read feeds, and Windows support is something you should test yourself. If your goal is to bring Nostr community actions onto a blog or project page, a careful trial is worth the time.