Bitcoin subscriptions made easy. Lightning fast. ⚡
SubscriptN is a Bitcoin subscription management platform that enables automated Lightning payments for recurring services. Built with Next.js 15, TypeScript, and PostgreSQL, it connects BTCPay Server providers with shop owners through Lightning network and NWC (Nostr Wallet Connect).
- 🏠 Unified Dashboard: Complete infrastructure and shops management
- ⚡ Lightning Payments: NWC integration for secure Bitcoin payments
- 🖥️ 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/subscriptn-simple.git
cd subscriptn-simple
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/subscriptn
# Session & Security
SESSION_SECRET=your-session-secret
NWC_ENCRYPTION_KEY=your-32-char-hex-key
# Optional
NODE_ENV=development- Register and add your server details
- Set public/private status and available slots
- Configure lightning address for payments
- Monitor connected shops and payments
- Browse available BTCPay servers
- Connect Lightning wallet via NWC
- Create shop and set up subscriptions
- Track payment history and status
- 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 AGENTS.md with comprehensive guidelines for AI coding assistants.
- ✅ Complete NWC payment system
- ✅ PostgreSQL migration and Docker support
- ✅ Unified homepage dashboard
- ✅ Security fixes and validation
- ✅ API consistency improvements
- Fixed critical password sanitization vulnerability
- Removed legacy code duplication
- Standardized API field naming (snake_case)
- Enhanced security and validation
What is SubscriptN? A Bitcoin subscription platform connecting BTCPay Server providers with shop owners through Lightning payments.
Do I need my own BTCPay Server? No, you can browse and connect to public servers listed on the platform.
What wallets are supported? NWC (Nostr Wallet Connect) compatible wallets like Alby, Zeus, Mutiny, and Coinos.
Is this production-ready? Yes, the core functionality is complete with enterprise-grade security measures.
- Contact: [email protected]
- Issues: GitHub Issues
- Documentation: See individual
.mdfiles for detailed guides
Built with ❤️ for the Bitcoin community