🎨 Reseller Branding Guide

Complete customization guide for white-labeling your Vaja AI dashboard

Overview

As a Vaja reseller, you can completely customize the look and feel of your dashboard to match your brand identity. This guide explains how to rebrand your platform so it appears as your own product.

💡 Pro Tip: Changes made via API are applied immediately. No restart required!

What Can Be Customized?

FREE TIER Included Features

Company Name - Your brand name shown throughout the dashboard
Logo URL - Your logo displayed in the header
Primary Color - Main brand color (hex code)
Secondary Color - Accent color for UI elements
Support Email - Your support contact email
Custom Subdomain - yourcompany.vaja.ai

PREMIUM Advanced Features

Custom Domain - dashboard.yourcompany.com
SSL Certificate - Automatic HTTPS setup
Favicon URL - Custom favicon for browser tabs
Support URL - Link to your support portal

Method 1: Update Branding via API (Recommended)

Step 1: Get Your JWT Token

curl -X POST https://yourcompany.vaja.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@yourcompany.com",
    "password": "your-password"
  }'

Response:

{
  "success": true,
  "user": { ... },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

⚠️ Important: Save the token value - you'll use it in all subsequent API calls.

Step 2: Get Current Branding Settings

curl https://yourcompany.vaja.ai/api/v1/reseller/branding \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response:

{
  "success": true,
  "branding": {
    "subdomain": "yourcompany",
    "custom_domain": null,
    "custom_domain_verified": false,
    "logo_url": null,
    "favicon_url": null,
    "primary_color": "#3B82F6",
    "secondary_color": "#10B981",
    "company_name": "Your Company Name",
    "support_email": "support@yourcompany.com",
    "support_url": null
  }
}

Step 3: Update Branding

curl -X PUT https://yourcompany.vaja.ai/api/v1/reseller/branding \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "logo_url": "https://yourcompany.com/logo.png",
    "favicon_url": "https://yourcompany.com/favicon.ico",
    "primary_color": "#10B981",
    "secondary_color": "#3B82F6",
    "company_name": "Acme Voice AI",
    "support_email": "support@acmevoice.com",
    "support_url": "https://support.acmevoice.com"
  }'

✨ Success! Changes are applied immediately. Refresh your dashboard to see the new branding.

Branding Options Reference

Logo URL

Format: HTTPS URL to your logo image
Recommended Size: 180x40 pixels (or similar aspect ratio)
File Types: PNG (recommended), SVG, JPG
Example: https://yourcompany.com/assets/logo.png

Best Practices:

✅ Use transparent background (PNG/SVG)
✅ Optimize file size (< 100KB)
✅ Host on a CDN for fast loading
✅ Use high-resolution for retina displays (2x)
✅ Ensure public HTTPS access

Favicon URL

Format: HTTPS URL to your favicon image
Recommended Size: 32x32 or 64x64 pixels
File Type: ICO or PNG
Example: https://yourcompany.com/favicon.ico

Primary & Secondary Colors

Format: Hex color code (e.g., #10B981)
Primary Color Used For: Buttons, links, main accents
Secondary Color Used For: Hover states, secondary UI elements

Popular Brand Colors:

Brand	Color	Hex Code
Salesforce Blue		`#00A1E0`
Stripe Purple		`#635BFF`
Slack Aubergine		`#4A154B`
Twilio Red		`#F22F46`

Color Picker Tools:

coolors.co - Generate color palettes
htmlcolorcodes.com - Pick and convert colors

Company Name

Format: Text string (e.g., "Acme Voice AI")
Used For: Dashboard header, page titles, email templates
Character Limit: 50 characters recommended

Support Email & URL

Email Format: Valid email address
URL Format: HTTPS URL to your support portal
Used For: Support links, contact information throughout the dashboard

Custom Domain Setup (PREMIUM)

Step 1: Add Your Custom Domain via API

curl -X POST https://yourcompany.vaja.ai/api/v1/reseller/branding/custom-domain \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_domain": "dashboard.acmevoice.com"
  }'

Step 2: Configure DNS Settings

Add a CNAME record in your DNS provider:

DNS Configuration:

Type:   CNAME
Name:   dashboard
Target: vaja.ai
TTL:    3600 (or Auto)

Common DNS Providers:

Cloudflare: DNS → Records → Add Record
GoDaddy: DNS Management → Add CNAME
Namecheap: Advanced DNS → Add New Record
AWS Route53: Hosted Zones → Create Record

Step 3: Contact Support for SSL Setup

Once DNS is configured, contact Vaja support at support@vaja.ai with:

Your organization name
Custom domain name
Confirmation that DNS is configured

⏱️ Timeline: SSL setup usually takes 10-15 minutes after DNS propagates.

Step 4: Verify Setup

# Check DNS propagation
nslookup dashboard.acmevoice.com

# Test HTTPS connection
curl -I https://dashboard.acmevoice.com/health

# Verify SSL certificate
openssl s_client -connect dashboard.acmevoice.com:443

Testing Your Branding

1. Clear Browser Cache

Chrome: Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
Firefox: Ctrl+Shift+Delete
Safari: Cmd+Option+E

2. Check Branding Elements

Visit your dashboard and verify:

✅ Logo: Appears in top-left header
✅ Favicon: Shows in browser tab
✅ Company Name: Displays in page titles and headers
✅ Primary Color: Used for buttons and links
✅ Secondary Color: Used for hover states
✅ Support Email: Appears in footer/contact links

3. Test Across Pages

Verify branding consistency on:

Dashboard home
API Keys page
Usage & Analytics
Settings
Customer management

Common Issues & Troubleshooting

Issue: Logo Not Showing

Possible Causes:

❌ URL not accessible (404 error)
❌ CORS blocking the image
❌ HTTP URL instead of HTTPS

Solutions:

# Test if logo URL is accessible
curl -I https://yourcompany.com/logo.png

# Should return: HTTP/2 200
# Content-Type: image/png

Ensure your server allows CORS:

Access-Control-Allow-Origin: *

Issue: Color Not Applying

Possible Causes:

❌ Invalid hex code format
❌ Browser cache showing old color
❌ Missing # symbol

Solutions:

Use valid hex format: #RRGGBB (e.g., #10B981)
Clear browser cache completely
Verify with API: GET /api/v1/reseller/branding

Issue: Custom Domain Not Working

Possible Causes:

❌ DNS not propagated yet (wait 5-60 minutes)
❌ CNAME pointing to wrong target
❌ SSL certificate not installed yet

Check DNS Propagation:

# Using nslookup
nslookup dashboard.acmevoice.com

# Expected output:
# dashboard.acmevoice.com canonical name = vaja.ai

# Online tool
# Visit: https://dnschecker.org/

Complete Rebranding Examples

Example 1: AIGuru (Free Tier with Subdomain)

curl -X PUT https://aiguru.vaja.ai/api/v1/reseller/branding \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "logo_url": "https://aiguru.pro/assets/logo.png",
    "favicon_url": "https://aiguru.pro/favicon.ico",
    "primary_color": "#3B82F6",
    "secondary_color": "#10B981",
    "company_name": "AI Guru",
    "support_email": "support@aiguru.pro",
    "support_url": "https://aiguru.pro"
  }'

Result:

✅ Blue/green theme matching their brand
✅ Logo and favicon displayed
✅ All support links go to aiguru.pro
✅ Accessible at: https://aiguru.vaja.ai

Example 2: Acme Voice AI (Premium with Custom Domain)

# 1. Update branding
curl -X PUT https://acmevoice.vaja.ai/api/v1/reseller/branding \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "logo_url": "https://cdn.acmevoice.com/logo.svg",
    "favicon_url": "https://cdn.acmevoice.com/favicon.ico",
    "primary_color": "#8B5CF6",
    "secondary_color": "#EC4899",
    "company_name": "Acme Voice AI",
    "support_email": "help@acmevoice.com",
    "support_url": "https://support.acmevoice.com"
  }'

# 2. Add custom domain
curl -X POST https://acmevoice.vaja.ai/api/v1/reseller/branding/custom-domain \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_domain": "dashboard.acmevoice.com"
  }'

# 3. Configure DNS (in Cloudflare/GoDaddy/etc)
# Type: CNAME
# Name: dashboard
# Target: vaja.ai

# 4. Contact Vaja support for SSL setup

# 5. Access at https://dashboard.acmevoice.com

Result:

✅ Purple/pink theme
✅ Custom domain with SSL
✅ Fully white-labeled experience
✅ Customers never see "Vaja" branding

Launch Checklist

Before launching your white-labeled platform:

Logo uploaded and accessible via HTTPS
Favicon created and accessible
Primary color matches your brand
Secondary color complements primary
Company name updated in branding API
Support email is monitored
Support URL links to your portal
Custom domain configured (if PREMIUM)
SSL certificate working (if custom domain)
DNS propagated globally
Tested login on all domains
Verified branding on all dashboard pages
Cleared browser cache and tested
Created test customer account
Verified customer-facing branding
Tested API key generation
Verified usage analytics display

🚀 Ready to launch! Once all items are checked, your white-labeled platform is ready for customers.

API Reference Summary

Get Current Branding

GET /api/v1/reseller/branding
Authorization: Bearer YOUR_JWT_TOKEN

Update Branding

PUT /api/v1/reseller/branding
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "logo_url": "https://yourcompany.com/logo.png",
  "favicon_url": "https://yourcompany.com/favicon.ico",
  "primary_color": "#10B981",
  "secondary_color": "#3B82F6",
  "company_name": "Your Company Name",
  "support_email": "support@yourcompany.com",
  "support_url": "https://support.yourcompany.com"
}

Set Custom Domain

POST /api/v1/reseller/branding/custom-domain
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
  "custom_domain": "dashboard.yourcompany.com"
}

Response Format

{
  "success": true,
  "branding": {
    "subdomain": "yourcompany",
    "custom_domain": "dashboard.yourcompany.com",
    "custom_domain_verified": true,
    "logo_url": "https://yourcompany.com/logo.png",
    "favicon_url": "https://yourcompany.com/favicon.ico",
    "primary_color": "#10B981",
    "secondary_color": "#3B82F6",
    "company_name": "Your Company Name",
    "support_email": "support@yourcompany.com",
    "support_url": "https://support.yourcompany.com"
  }
}

Need Help?

Contact Support:

📧 Email: support@vaja.ai
📚 Reseller Onboarding: Onboarding Guide
📖 API Documentation: API Docs

Test Your Setup:

# Health check
curl https://yourcompany.vaja.ai/health

# Login test
curl -X POST https://yourcompany.vaja.ai/api/auth/login \
  -d '{"email":"admin@yourcompany.com","password":"pass"}'

# Branding check
curl https://yourcompany.vaja.ai/api/v1/reseller/branding \
  -H "Authorization: Bearer YOUR_TOKEN"

💬 Questions? Our team is here to help you set up your perfect white-labeled experience!