Skip to main content

License Key Format Update - Summary ✅

🎯 Issue Identified​

The documentation showed examples using pswp_prod_ prefix format, but Lemon Squeezy generates UUID format by default (like 12345678-1234-1234-1234-123456789ABC).

This created confusion about what format customers would actually receive.

✅ Solution Implemented​

1. Validation Logic (Already Correct!)​

The code already supports both formats:

// From src/pro/license.js
const looksRight = 
  /^pswp_[a-z0-9_]{4,}$/i.test(key) ||           // Custom prefix
  /^[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12}$/i.test(key);  // UUID

Test Results:

  • ✅ UUID format: 12345678-1234-1234-1234-123456789ABC → VALID
  • ✅ Custom format: pswp_prod_abc123def456 → VALID
  • ✅ Demo format: pswp_demo_test1234 → VALID
  • ✅ Short custom: pswp_test → VALID

2. Documentation Updated​

New Comprehensive Guide:​

  • Created docs/LICENSE-KEY-FORMATS.md
  • Explains both UUID and custom prefix formats
  • Shows validation logic and examples
  • Recommends UUID format for simplicity

Updated Existing Docs:​

  • docs/LEMON-SQUEEZY-SETUP.md - Shows UUID as default
  • docs/CUSTOMER-JOURNEY.md - Uses UUID in examples
  • docs/AI-MODEL-INTEGRATION.md - Updated examples

3. Demo UI Updated​

Before:​

placeholder="pswp_demo_abcd1234"

After:​

placeholder="12345678-1234-1234-1234-123456789ABC"

Updated Components:

  • ✅ demo-docs-website/src/components/ProDemo/index.js
  • ✅ demo-docs-website/src/components/CustomerPortal/index.js

📊 Supported Formats​

Format 1: UUID (Lemon Squeezy Default) ✅ Recommended​

Format:  XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Example: 12345678-1234-1234-1234-123456789ABC

Setup: None required! Lemon Squeezy generates this automatically.

Format 2: Custom Prefix (Optional)​

Format:  pswp_XXXX_XXXXXXXXXXXX
Example: pswp_prod_abc123def456

Setup: Configure custom prefix in Lemon Squeezy (if available)

🔧 What Changed​

Code Changes:​

  • ❌ No code changes needed! Validation already supported both formats

Documentation Changes:​

  1. ✅ Created comprehensive format guide
  2. ✅ Updated setup instructions to clarify UUID is default
  3. ✅ Updated all examples to show UUID format first
  4. ✅ Clarified custom prefix is optional

UI Changes:​

  1. ✅ Updated demo placeholders to show UUID format
  2. ✅ Updated help text to mention both formats
  3. ✅ Increased input width for longer UUID keys

🎯 Customer Impact​

What Customers Will See:​

In Purchase Email:

YOUR LICENSE KEY:
12345678-1234-1234-1234-123456789ABC

In Demo:

License Key: [12345678-1234-1234-1234-123456789ABC]
             ↑ UUID format (default)

Both Formats Work:

  • Customers with UUID keys: ✅ Works
  • Customers with pswp_ keys: ✅ Works
  • No migration needed!

📋 Setup Recommendation​

For New Users:​

  1. Create product in Lemon Squeezy
  2. Enable "License Keys" toggle
  3. Stop! Use UUID format (default)
  4. Test purchase → receive UUID key
  5. Key works immediately in Pro package

No custom prefix configuration needed! 🎉

🧪 Validation Testing​

# Test UUID format
curl -X POST http://localhost:4001/api/license/validate \
  -H 'Content-Type: application/json' \
  -d '{"licenseKey":"12345678-1234-1234-1234-123456789ABC"}'
# ✅ Response: {"valid":true}

# Test custom format
curl -X POST http://localhost:4001/api/license/validate \
  -H 'Content-Type: application/json' \
  -d '{"licenseKey":"pswp_demo_test1234"}'
# ✅ Response: {"valid":true}

✅ Summary​

Problem: Documentation showed pswp_prod_ format, but Lemon Squeezy uses UUID by default.

Solution:

  1. ✅ Clarified UUID is the default format
  2. ✅ Updated all examples to show UUID first
  3. ✅ Documented both formats are supported
  4. ✅ No code changes needed - validation already works!

Result: Clear, accurate documentation that matches what customers actually receive from Lemon Squeezy.

Recommendation: Use UUID format (Lemon Squeezy default) for easiest setup! 🚀