Bitcoin Infrastructure & Shop Marketplace. Lightning fast. ⚡
Bitinfrashop is a Bitcoin infrastructure and shop marketplace that connects infrastructure providers (BTCPay Server, BLFS, and more) with Bitcoin-accepting shops. Built with Next.js 15, TypeScript, and PostgreSQL, it enables automated Lightning payments and seamless connections through NWC (Nostr Wallet Connect).
- 🏠 Unified Dashboard: Complete infrastructure and shops management
- ⚡ Lightning Payments: NWC integration for secure Bitcoin payments
- 🗺️ BTCMap Integration: Real-time discovery of Bitcoin-accepting shops worldwide with interactive map
- 🏪 Marketplace: Browse infrastructure providers and shops with filtering, search, and categories
- 🖥️ BTCPay Marketplace: Browse and connect to public servers
- 🛍️ Shop Management: Create shops with automated subscriptions
- 🔐 Secure Wallets: Encrypted NWC connection strings
- 👁️ Visibility Control: Public/private options for servers and shops
- 📊 Real-time Tracking: Live payment monitoring
- 🐳 Docker Ready: Full containerization with PostgreSQL
- 🔒 Enterprise Security: Rate limiting, validation, and encryption
- Node.js 18+
- Lightning wallet (NWC compatible)
- PostgreSQL (or use Docker)
# Clone and install
git clone https://github.com/NodeDiver/bitinfrashop.git
cd bitinfrashop
npm install
# Configure environment
cp env.example .env.local
# Edit .env.local with your settings
# Start development server
npm run dev# Start with Docker Compose
docker-compose up -d
# Access application
open http://localhost:3003# Database
DATABASE_URL=postgresql://postgres:password@localhost:5433/bitinfrashop
# Session & Security
SESSION_SECRET=your-session-secret
NWC_ENCRYPTION_KEY=your-32-char-hex-key
# Optional
NODE_ENV=developmentBitinfrashop is a unified platform - all users have access to all features without role distinctions:
- Register: Create your account with username and password
- Explore: Browse infrastructure providers and Bitcoin-accepting shops
- List Services: Add your BTCPay server, Lightning node, or other Bitcoin infrastructure
- Manage Shops: Create and list your Bitcoin-accepting business
- Connect: Make connections with optional NWC-powered subscriptions
- Discover: Use the integrated BTCMap to find Bitcoin businesses worldwide
- Infrastructure Providers: List services, set availability, configure Lightning addresses
- Shop Management: Create shops, connect to infrastructure, manage subscriptions
- Discovery: Interactive map view with BTCMap integration for finding Bitcoin merchants
- Payments: Optional automated Lightning payments via NWC for subscriptions
Complete documentation is available in the docs/ folder:
- Documentation Index - Start here
- Product Vision - What we're building and why
- Feature Development Workflow - How we build features
- AI Agent Guidelines - AI assistant integration
- Architecture Decisions - Technical choices and rationale
- Encryption: AES-256-GCM for NWC secrets
- Rate Limiting: API endpoint protection
- Input Validation: Comprehensive sanitization
- Authentication: Session-based security
- Database: PostgreSQL with proper indexing
See SECURITY.md for detailed information.
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
This project includes comprehensive documentation for AI coding assistants:
- ✅ Complete NWC payment system
- ✅ PostgreSQL migration and Docker support
- ✅ Unified homepage dashboard
- ✅ Security fixes and validation
- ✅ API consistency improvements
- ✅ Comprehensive documentation framework
- 🏪 Marketplace Transformation: Evolved from subscription tool to full Bitcoin marketplace
- 🗺️ BTCMap Integration: Real-time discovery with interactive map showing Bitcoin merchants worldwide
- 🔍 Enhanced Discovery: Filtering, search, and categories for infrastructure providers and shops
- 🔗 Connection System: Shops can find and connect with Lightning infrastructure providers
- 📱 Improved UX: Shop type labels (Online Store/Physical Shop), aligned card layouts, sticky footer patterns
- 🔢 Counter Fixes: Accurate marketplace totals display
- 🔔 Notification System: Shops can seek and connect with infrastructure providers
- 🎨 Platform Unification: Removed user role distinctions - all users access all features
- 🎨 Unified Color Scheme: Transitioned to warm orange/amber branding reflecting Bitcoin's energy
- 🏗️ Database Schema: Simplified User model by removing role field
- 🎯 Homepage Redesign: Unified hero section with feature-focused layout
- 📝 Registration Flow: Streamlined signup without role selection
- 🔧 Auth System: Updated APIs and authentication to support unified model
- 📚 Enhanced Documentation: BMAD-METHOD inspired organization
- 🤖 Claude Code Integration: Complete AI assistant documentation
See Development Log for detailed history.
What is Bitinfrashop? A Bitcoin marketplace connecting infrastructure providers with Bitcoin-accepting shops worldwide, featuring automated Lightning payments, BTCMap integration for global discovery, and seamless NWC-powered connections.
Do I need my own BTCPay Server? No, you can browse and connect to public servers listed on the platform marketplace.
What wallets are supported? NWC (Nostr Wallet Connect) compatible wallets like Alby, Zeus, Mutiny, and Coinos.
How does BTCMap integration work? The discover page features an interactive map showing Bitcoin-accepting businesses globally from BTCMap, with filtering and search capabilities.
Is this production-ready? Yes, the core functionality is complete with enterprise-grade security measures.
- Contact: [email protected]
- Issues: GitHub Issues
- Documentation: Complete docs
Built with ❤️ for the Bitcoin community