Skip to content

Buho-Ecosystem/Buho_go

Repository files navigation

BuhoGO

Bitcoin & Lightning Wallet for Web and Mobile

BuhoGO is an open-source wallet application that makes Bitcoin & Lightning payments accessible to everyone. Whether you prefer self-custody with Spark or want to connect your existing wallet via NWC or LNBits, BuhoGO provides a clean, intuitive interface for everyday Bitcoin transactions.

Live App | Report Issues

BuhoGO header


Features

Two Wallet Options

Spark Wallet (Self-Custodial)

  • Generate a new wallet with 12-word seed phrase
  • Full control over your Bitcoin with PIN-protected encryption
  • Zero-fee instant transfers to other Spark users
  • Standard Lightning Network payments with minimal fees

NWC Connected Wallet

  • Connect any Nostr Wallet Connect compatible wallet
  • Use your existing Lightning setup (LNBits, Alby, Primal, Buho etc.)
  • Multiple NWC wallets supported simultaneously
  • No seed phrase management required

Payment Capabilities

Feature Spark NWC
Pay Lightning Invoices Yes Yes
Pay Lightning Addresses Yes Yes
Pay LNURL Requests Yes Yes
Receive Lightning Yes Yes
Spark-to-Spark Transfers Yes No
Zero-Fee Transfers Yes No

Additional Features

  • QR Scanner: Scan invoices, addresses, and LNURL codes
  • Address Book: Save contacts with Lightning or Spark addresses
  • Transaction History: Complete record of all payments
  • Multi-Wallet: Switch between wallets instantly
  • Dark and Light Themes: Choose your preferred appearance
  • Multi-Language: Available in multiple languages
  • Real-Time Prices: Bitcoin price display in your currency

Screenshots

Interface Themes

Dark Mode Light Mode

Welcome Screen

Welcome Screen

Send and Receive

Create/Send

Spark Wallet Setup

Create Seed Verify Backup Wallet Ready

Transaction History

Transactions Expanded Transactions Collapsed


Quick Start

Installation

# Clone the repository
git clone https://github.com/Buho-Ecosystem/Buho_go.git
cd Buho_go

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:9000

Production Build

npm run build

Build output will be in the dist/spa directory.


Getting Started

For detailed step-by-step instructions, see the User Guide.

Option A: Create a Spark Wallet

  1. Open the app and select "Create Wallet"
  2. Write down your 12-word seed phrase (this is your backup)
  3. Verify your backup by entering 3 random words
  4. Set a 6-digit PIN to protect your wallet
  5. Start sending and receiving Bitcoin

See Setting Up a Spark Wallet for detailed instructions.

Option B: Connect an NWC Wallet

  1. Open the app and select "Connect Wallet"
  2. Get your NWC connection string from your wallet provider
  3. Paste the string or scan the QR code
  4. Your wallet is now connected

See Connecting an NWC Wallet for detailed instructions.

Making Payments

BuhoGO accepts multiple payment formats:

  • Lightning Invoice: Strings starting with lnbc...
  • Lightning Address: Email-like format name@domain.com
  • LNURL: Encoded payment requests starting with lnurl...
  • Spark Address: Strings starting with sp1... (Spark wallets only)

Simply scan a QR code or paste the payment destination and the app handles the rest.


Security

For technical details on the encryption implementation, see the Developer Guide.

Spark Wallet Security

  • Seed phrases are encrypted with AES-256-GCM
  • PIN is required to unlock and view seed phrase
  • Private keys never leave your device
  • No server-side storage of sensitive data

NWC Wallet Security

  • Connection strings stored locally only
  • Each wallet operates independently
  • Non-custodial architecture throughout

Best Practices

  • Back up your Spark seed phrase securely offline
  • Use a unique PIN you can remember
  • Verify recipient addresses before sending
  • Start with small amounts when testing

Tech Stack

For detailed architecture documentation, see the Developer Guide.

Component Technology
Framework Vue.js 3
UI Library Quasar Framework
State Management Pinia
Build Tool Vite
Lightning (Spark) @buildonspark/spark-sdk
Lightning (NWC) @getalby/sdk
Mobile Capacitor (iOS/Android)

Project Structure

src/
  components/       # Reusable Vue components
  pages/            # Application pages/routes
  providers/        # Wallet provider implementations
  stores/           # Pinia state stores
  css/              # Global styles
  i18n/             # Internationalization files
  router/           # Vue Router configuration

Documentation


Contributing

Contributions are welcome. Please read the Developer Guide before contributing.

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes following the Styling Guidelines
  4. Submit a pull request

License

MIT License - Use it, modify it, contribute back.


Links


Built for the Bitcoin community by people who use Bitcoin every day.

About

Fast & Light Bitcoin and Lightning Wallet with Spark, Nostr Wallet Connect & LNBits

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages