https://github.com/lachispame/lachispa
A mobile interface to easily connect with any LNbits instance
https://github.com/lachispame/lachispa
bitcoin lightning-network lnbits wallet
Last synced: about 1 month ago
JSON representation
A mobile interface to easily connect with any LNbits instance
- Host: GitHub
- URL: https://github.com/lachispame/lachispa
- Owner: lachispame
- License: mit
- Created: 2025-07-28T18:43:25.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-02-21T08:17:59.000Z (4 months ago)
- Last Synced: 2026-02-21T15:28:08.393Z (4 months ago)
- Topics: bitcoin, lightning-network, lnbits, wallet
- Language: Dart
- Homepage: https://app.lachispa.me
- Size: 47.6 MB
- Stars: 15
- Watchers: 3
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LaChispa ⚡
[](https://deepwiki.com/lachispame/lachispa)
*Ask questions about this project using DeepWiki AI*
**A modern and easy-to-use mobile Lightning Network wallet**
---
## 📱 About LaChispa
LaChispa is a modern mobile application developed in Flutter that allows you to manage Bitcoin through Lightning Network using LNBits as backend. Designed with an intuitive interface and attractive visual effects, it makes Lightning Network usage accessible for everyone.
### ✨ Key Features
- **🔐 Secure Authentication**: Login and registration with multiple LNBits servers
- **💼 Wallet Management**: Support for multiple wallets with automatic selection
- **⚡ Lightning Payments**: Send and receive instant Lightning payments
- **📧 Lightning Address**: Create and manage personalized Lightning Addresses
- **🎯 Multiple Formats**: Support for BOLT11, LNURL, and Lightning Address
- **💱 Currency Conversion**: Integration with Yadio.io for USD, CUP and sats (more denominations coming)
- **📊 Complete History**: Detailed visualization of all transactions
- **🌐 Multiplatform**: Android, iOS, Web, Windows, macOS and Linux
## 🚀 Screenshots
| Welcome Screen | Home Screen | Send Payment | Receive Payment | Transaction History |
|:--:|:--:|:--:|:--:|:--:|
| *Easy onboarding* | *Wallet management* | *Multiple formats* | *QR code generation* | *Complete transaction log* |
## 🔧 Technologies Used
### Frontend
- **Flutter 3.0+**: Cross-platform framework
- **Dart**: Programming language
- **Provider**: State management
- **QR Flutter**: QR code generation
- **Mobile Scanner**: QR code scanning
### Backend & APIs
- **LNBits**: Lightning Network server
- **Yadio.io**: Exchange rate conversion
- **Lightning Network**: Payment protocol
### Technical Features
- **Secure Storage**: Secure credential storage
- **Dio HTTP Client**: Optimized HTTP requests
- **Real-time Updates**: Automatic balance updates
- **Responsive Design**: Automatic adaptation to different screen sizes
## 📦 Installation
### Prerequisites
- Flutter SDK (>=3.0.0)
- Dart SDK
- Configured LNBits server
### Clone the Repository
```bash
git clone https://github.com/Forte11Cuba/lachispa.git
cd lachispa
```
### Install Dependencies
```bash
flutter pub get
```
### Run the app in emulator
```bash
flutter run
```
### Build for your Platform
**Android:**
```bash
flutter build apk --release
```
**iOS:**
```bash
flutter build ios --release
```
**Web:**
```bash
flutter build web --release
```
**Desktop:**
```bash
flutter build windows --release # Windows
flutter build macos --release # macOS
flutter build linux --release # Linux
```
## ⚙️ Configuration
### LNBits Servers
The application comes preconfigured with public LNBits servers, but you can add your own server:
1. Open the application
2. Go to "Change server"
3. Select "Custom server"
4. Enter your LNBits server URL
## 🏗️ Architecture
### Project Structure
```
lib/
├── main.dart # Entry point
├── models/ # Data models
│ ├── wallet_info.dart
│ ├── lightning_invoice.dart
│ └── ln_address.dart
├── providers/ # State management
│ ├── auth_provider.dart
│ ├── wallet_provider.dart
│ └── ln_address_provider.dart
├── screens/ # Application screens
│ ├── 1welcome_screen.dart
│ ├── 6home_screen.dart
│ └── ...
├── services/ # API services
│ ├── auth_service.dart
│ ├── wallet_service.dart
│ └── invoice_service.dart
└── widgets/ # Reusable components
├── qr_scanner_widget.dart
└── spark_effect.dart
```
## 🔐 Security
- **Secure Storage**: Locally encrypted credentials
- **HTTPS Only**: All communications encrypted
- **No Logging**: No sensitive information logging
- **Session Management**: Secure session management
- **Input Validation**: Comprehensive input validation
## 📱 Compatibility
### Supported Platforms
- ✅ Android (API 21+)
- ✅ iOS (iOS 12.0+)
- ✅ Web (Chrome, Firefox, Safari)
- ✅ Windows (Windows 10+)
- ✅ macOS (macOS 10.14+)
- ✅ Linux (Ubuntu 18.04+)
## 🤝 Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a branch for your feature (`git checkout -b feature/new-feature`)
3. Commit your changes (`git commit -m 'Add new feature'`)
4. Push to the branch (`git push origin feature/new-feature`)
5. Open a Pull Request
## 📄 License
This project is under the MIT License - see the [LICENSE](LICENSE) file for more details.