Ario Web App

A modular Vue 3 + TypeScript application with Nostr protocol integration and Lightning Network wallet functionality.

Features

• Modular Architecture: Plugin-based system with dependency injection
• Nostr Integration: Decentralized social networking and messaging
• Lightning Wallet: Real-time balance updates with LNbits WebSocket integration
• Event Ticketing: Lightning-powered event tickets and marketplace
• PWA Support: Progressive Web App with offline capabilities
• Desktop App: Electron-based desktop application

Real-Time Wallet Features

The application provides seamless Lightning Network wallet integration:

• Lightning Invoice Creation: Create BOLT11 invoices for receiving payments with QR codes
• Smart Payment Scanning: QR code scanner for Lightning invoices, LNURL, and Lightning addresses
• Universal Payment Support: Send to Lightning invoices, Lightning addresses (user@domain.com), and LNURL
• Smart Amount Fields: Amount input only appears when needed (LNURL, Lightning addresses, or zero-amount invoices)
• Instant Balance Updates: WebSocket connection provides real-time balance updates when payments are sent or received
• Live Notifications: Toast notifications for incoming payments
• Connection Management: Automatic reconnection with exponential backoff
• Battery Optimization: Pauses WebSocket when app is not visible to save battery
• Multi-Wallet Support: Manages multiple Lightning wallets with the first wallet as default

WebSocket Configuration

Configure WebSocket behavior in src/app.config.ts:

modules: {
  wallet: {
    enabled: true,
    config: {
      websocket: {
        enabled: true,           // Enable/disable real-time updates
        reconnectDelay: 1000,    // Initial reconnection delay (ms)
        maxReconnectAttempts: 5  // Maximum reconnection attempts
      }
    }
  }
}

Development

# Install dependencies
npm install

# Start development server with hot reload
npm run dev

# Build for production
npm run build

# Run Electron desktop app
npm run electron:dev

Environment Setup

Required environment variables:

# LNbits server URL for Lightning wallet functionality
VITE_LNBITS_BASE_URL=http://localhost:5000

# Nostr relay configuration (JSON array)
VITE_NOSTR_RELAYS='["wss://relay1.example.com","wss://relay2.example.com"]'

Architecture

The application follows a modular architecture with the following core modules:

• Base Module: Authentication, Nostr client, PWA functionality
• Wallet Module: Lightning payments, WebSocket balance updates, transaction management
• Events Module: Event ticketing with Lightning payment integration
• Market Module: Nostr marketplace functionality
• Chat Module: Encrypted messaging via Nostr

For detailed development guidelines, see CLAUDE.md.