Demo Mode

Demo mode lets you experience the full functionality of Prompt Stack without any external dependencies. Perfect for development, testing, and showcasing your application.

What is Demo Mode?

Demo mode provides fully functional mock implementations of all external services:

Enabling Demo Mode

Automatic (Default)

Demo mode is automatically enabled when no external services are configured:

# backend/.env
DEMO_MODE=auto  # Default value

# If no API keys are found, demo mode activates

Force Demo Mode

Always use demo implementations regardless of configuration:

# backend/.env
DEMO_MODE=true  # Force demo mode

# Even if API keys exist, demo mode is used

Disable Demo Mode

Require real services (app won't work without them):

# backend/.env
DEMO_MODE=false  # Disable demo mode

# Real API keys must be configured

Demo Authentication

Sign In

Email: test@example.com (or any email)
Password: password123 (or any password)

# First user automatically becomes admin
# Subsequent users are regular users

Demo Endpoints

# Sign up
POST /api/auth/demo/signup
{
  "email": "any@email.com",
  "password": "anypassword"
}

# Sign in
POST /api/auth/demo/signin
{
  "email": "any@email.com",
  "password": "anypassword"
}

# Returns demo JWT token
{
  "success": true,
  "data": {
    "user": { "id": "demo_123", "email": "any@email.com" },
    "session": { "access_token": "demo_jwt_token" }
  }
}

Demo AI Responses

Pre-programmed Responses

Demo mode includes intelligent responses for common prompts:

Prompt: "Hello" or "Hi"
Response: "Hello! I'm the Prompt Stack demo AI assistant. 
How can I help you explore the features today?"

Prompt: "Write a function" or "code"
Response: "Here's a simple function example:

```python
def greet(name):
    return f'Hello, {name}! Welcome to Prompt Stack!'
```"

Prompt: Any other text
Response: "This is a demo response. In production, 
this would be processed by your chosen AI provider 
(OpenAI, Anthropic, etc.)"

Demo AI Endpoint

# Generate demo response
POST /api/llm/generate-demo
{
  "prompt": "Hello AI",
  "model": "demo",
  "stream": false
}

# Streaming demo
POST /api/llm/generate-demo
{
  "prompt": "Tell me a story",
  "stream": true
}
# Returns SSE stream with typed characters

Demo Payments

Test Checkout Flow

1. Click any "Subscribe" or "Buy" button
2. Demo checkout page appears
3. Use any test card number (e.g., 4242 4242 4242 4242)
4. Payment "succeeds" instantly
5. Subscription appears in user profile

Demo Payment Endpoints

# Create checkout session
POST /api/payments-demo/create-checkout
{
  "price_id": "demo_price_123",
  "success_url": "/success",
  "cancel_url": "/pricing"
}

# Returns demo checkout URL
{
  "success": true,
  "data": {
    "url": "/demo/checkout?session_id=demo_cs_123"
  }
}

Demo Vector Search

How It Works

Demo mode includes pre-indexed content for testing vector search:

Search Examples

# Search for similar content
POST /api/vectors/search-demo
{
  "query": "How do I add authentication?",
  "limit": 5
}

# Returns relevant documents
{
  "success": true,
  "data": {
    "results": [
      {
        "content": "Authentication Best Practices...",
        "similarity": 0.92
      }
    ]
  }
}

Demo Mode vs Production

Demo Mode Indicators

The UI clearly shows when demo mode is active:

Testing in Demo Mode

Recommended Test Flow

1. Sign Up: Create account with any email
2. Explore Auth: Try login, logout, profile update
3. Test AI: Go to /test-ai and try prompts
4. Try Payments: Subscribe to a plan
5. Search: Test vector search functionality
6. Check API: Visit /api/docs for documentation

Demo Mode Limitations

• ❌ Data resets when containers restart
• ❌ Limited AI response variety
• ❌ No real payment processing
• ❌ No email sending
• ❌ Fixed vector search results

Transitioning from Demo to Production

Migration Steps

1. Add Supabase first

   ./setup.sh supabase

   Real auth and database, demo everything else

2. Add AI providers

   ./setup.sh ai

   Real AI responses, demo payments

3. Add payment processing

   ./setup.sh payments

   Full production mode

4. Disable demo mode

   DEMO_MODE=false

   Require all real services