Practical overview
When it fits
Use it when a website needs an embedded Lightning payment prompt and the recipient is available as a Lightning Address or LNURL.
Who it is for
- Creators seeking to add a Lightning donation button to a website.
- Organizations and site operators needing a simple Lightning payment prompt.
Documented uses
- Embed a Bitcoin Lightning payment or donation widget on a website.
- Direct widget payments to a Lightning Address or LNURL.
- Customize the widget’s name, image, accent color, and initial button text.
Requirements & limits
The repository is public and MIT-licensed. The README documents an external embed script and a local npm-based development setup.
- The recipient must be configured as a Lightning Address or LNURL.
- The documented widget supports display customization and initialization-time settings validation.
- The README documents an embed-script approach; it does not lay out a complete payment transaction flow.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Configure and embed a Lightning Widget
Add the documented widget element and embed script to a website, configured with a Lightning payment recipient.
Before you start
- A website where you can add HTML markup and load an external script.
- A recipient Lightning Address or LNURL.
Steps
Add a element to the page and set its
tovalue to the Lightning Address or LNURL.Set any desired display attributes:
name,image,accent, andbutton-text.Load the widget script at
https://embed.twentyuno.net/js/app.js.
Expected outcome
The page contains a configured Lightning payment widget with the selected display settings and recipient.
Start the local development server
Install the project dependencies and start its documented development server.
Before you start
- A checkout of the Lightning Widget repository.
- npm available in the development environment.
Steps
Run the command below in the repository.
npm installRun the command below.
npm run serve
Expected outcome
The README says these commands spin up a development server.
Guide limitations
- The README does not specify further development, build, or deployment steps.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- reneaaron/lightning-widget · Official homepage title · retained in its source language

