ALPHA RELEASE: Source License is currently in Alpha. While feature-complete for most use cases, you may encounter issues. Please report bugs via GitHub Issues.

A comprehensive Ruby/Sinatra-based software licensing management system with integrated payment processing, secure license validation APIs, and enterprise-grade features for independent software vendors.

All detailed documentation has been moved to the Project Wiki

• Installation Guide - Complete setup instructions
• API Reference - REST API documentation
• Admin Guide - Administrative documentation
• Architecture Overview - System design and components
• Development Guide - Contributing and development setup

Source License is a complete solution for software vendors who need to sell, manage, and validate software licenses. Built with Ruby and Sinatra, it provides a robust platform for handling everything from product sales to license validation APIs that integrate directly into your software.

• Product Management: Create and manage software products with pricing, descriptions, and download files
• Shopping Cart & Checkout: Full e-commerce flow with cart functionality and secure checkout
• Payment Processing: Integrated Stripe and PayPal support with webhook-first PayPal flow and signature verification
• Order Management: Complete order tracking and fulfillment system

• Cryptographically Secure License Keys: Multiple formats (XXXX-XXXX-XXXX-XXXX, UUID, custom)
• Activation Control: Limit installations per license with machine fingerprinting
• License Types: Support for perpetual, subscription, and trial licenses
• License Operations: Suspend, revoke, extend, transfer, and batch generate licenses
• Validation API: REST endpoints for real-time license verification in your software

• Dashboard: Real-time statistics and system overview
• Product Management: Create products with pricing, trial periods, and download files
• License Administration: Generate, manage, and monitor all licenses
• Customer Management: Track users, orders, and support requests
• Order Processing: View, manage, and fulfill customer orders
• Reports & Analytics: Detailed insights into sales and license usage

• Template System: ERB templates with extensive helper functions
• Live Customization: Admin interface for colors, branding, and content
• Responsive Design: Bootstrap-based responsive layout
• Multi-language Ready: Template structure supports internationalization

• JWT Authentication: Secure API access with token-based auth
• Admin Role Management: Granular permissions and multi-admin support
• Security Middleware: CSRF protection, rate limiting, and security headers
• Audit Logging: Comprehensive logging of all license operations
• Database Security: Sequel ORM with prepared statements prevents SQL injection

• License Validation: Real-time license verification endpoints
• License Activation: Machine-based activation and deactivation
• Order Processing: Complete API for order creation and management
• Webhook Support: Stripe and PayPal webhook handling (PayPal uses verify-webhook-signature API for signature verification)
• Settings Management: API for configuration management

• Recurring Billing: Automatic subscription renewals
• Grace Periods: Handle failed payments gracefully
• Trial Management: Free trial periods with automatic conversion
• Billing History: Complete payment and billing tracking

• Ruby 3.4.7 or higher
• Database: MySQL, PostgreSQL, or SQLite (development only)
• Git for cloning the repository

1. Clone and install

   git clone https://github.com/PixelRidgeSoftworks/Source-License.git
   cd Source-License
   
   # Windows
   .\install.ps1 && .\deploy.ps1
   
   # Linux/macOS  
   ./install.sh && ./deploy.sh

2. Access the application

   • Website: http://localhost:4567
   • Admin Panel: http://localhost:4567/admin
   • License Lookup: http://localhost:4567/my-licenses

The installer creates a .env file from the template. Key settings to configure:

# Database (choose one)
DATABASE_ADAPTER=mysql          # or postgresql, sqlite
DATABASE_HOST=localhost
DATABASE_NAME=source_license
DATABASE_USER=your_username
DATABASE_PASSWORD=your_password

# Security
APP_SECRET=your_secure_secret_key
JWT_SECRET=your_jwt_secret_key

# Payment Processing (optional)
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_SECRET_KEY=sk_test_...
PAYPAL_CLIENT_ID=your_client_id
# Optional: set to 'true' to use webhook-first PayPal flow. When enabled, fulfillment occurs via verified webhooks.
PAYPAL_USE_WEBHOOKS=true

📖 For complete installation instructions, database setup, and configuration options, see the Installation Guide.

Built with a modular Ruby/Sinatra architecture:

Source-License/
├── app.rb                    # Main application entry point
├── launch.rb                # Cross-platform launcher
├── lib/                     # Core application logic
│   ├── models.rb            # Database models
│   ├── controllers/         # Modular controllers
│   ├── auth.rb             # Authentication system
│   └── payment_processor.rb # Payment integration
├── views/                   # ERB templates  
├── test/                    # Test suite
└── .env.example            # Configuration template

📖 For detailed architecture, database schema, and component documentation, see the Architecture Overview.

curl -X GET http://localhost:4567/api/license/XXXX-XXXX-XXXX-XXXX/validate

curl -X POST http://localhost:4567/api/license/XXXX-XXXX-XXXX-XXXX/activate \
  -d '{"machine_fingerprint": "unique_machine_id"}'

📖 For complete API documentation, authentication details, and code examples, see the API Reference.

• Admin Panel Customization: Live branding, colors, content editing
• Template System: ERB templates with extensive helper functions
• Development Setup: bundle install && ruby launch.rb
• Code Quality: RuboCop style enforcement and auto-fixing
• Production Deployment: Automated scripts for Windows/Linux/macOS

📖 For detailed customization guides, development setup, and deployment instructions, see the Development Guide.

• Sell desktop applications with license management
• Distribute plugins and extensions with activation limits
• Manage trial periods and subscription renewals
• Track usage analytics and license compliance

• License validation for client-side applications
• Machine-based activation for offline software
• Subscription management with automatic renewals
• Multi-tier licensing with different activation limits

• Student/teacher license management
• Institution-wide licensing
• Temporary access and trial periods
• Bulk license generation for schools

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Check code style (bundle exec rubocop)
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

• Issues: GitHub Issues
• Documentation: Project Wiki
• Discussions: GitHub Discussions

• ✅ Complete license management system
• ✅ Stripe and PayPal integration
• ✅ REST API with JWT authentication
• ✅ Admin dashboard and user management
• ✅ Cross-platform launcher
• ✅ Multiple database support

• 🔄 Advanced analytics and reporting
• 🌐 Multi-language support
• 📱 Mobile-responsive admin interface
• 🔧 Plugin system for extensions
• 📊 Advanced subscription management
• 🌍 International payment methods

Built with ❤️ using Ruby and Sinatra by the PixelRidge Softworks team

Source License - Empowering software vendors with professional licensing solutions