White-Labeling

TwinEdge Enterprise allows you to fully customize the platform appearance with your company branding.

Enterprise Feature

White-labeling is available exclusively on Enterprise plans.

Overview

White-label customization includes:

• Custom logo and favicon
• Brand colors and themes
• Custom domain
• Email templates
• Login page customization
• Footer and legal links

Branding Configuration

Access Branding Settings

1. Go to Settings → Branding
2. You'll see preview of current branding
3. Make changes in each section

Logo & Favicon

Logo Requirements

Type	Format	Dimensions	Max Size
Full Logo	PNG, SVG	200x50 px	500KB
Icon Logo	PNG, SVG	50x50 px	100KB
Favicon	ICO, PNG	32x32 px	50KB

Upload Logo

1. Click Logo section
2. Upload files:
   • Full Logo: Shown in sidebar and header
   • Icon Logo: Shown in collapsed sidebar
   • Favicon: Browser tab icon
3. Preview and adjust
4. Click Save

Color Scheme

Primary Colors

Color	Default	Usage
Primary	#00E5BF	Buttons, links, accents
Primary Hover	#00CCB3	Hover states
Background	#0B0F14	Page background
Surface	#151B23	Cards, modals
Border	#2A3441	Borders, dividers

Text Colors

Color	Default	Usage
Text Primary	#E8EAED	Headings
Text Secondary	#9AA0A9	Body text
Text Muted	#6B7280	Hints, labels

Status Colors

Color	Default	Usage
Success	#22C55E	Success states
Warning	#F59E0B	Warnings
Error	#EF4444	Errors
Info	#3B82F6	Information

Configure Colors

1. Click Colors section
2. Use color picker or enter hex values
3. Preview changes in real-time
4. Click Save

Dark/Light Mode

Configure theme options:

• Dark Mode Only: Default dark theme (recommended)
• Light Mode Only: Light theme only
• User Choice: Let users switch themes
• System Preference: Match user's OS setting

Typography

Font Options

Choose from:

• Inter (default)
• Roboto
• Open Sans
• Lato
• Custom Font (upload .woff2)

Custom Font

1. Upload font files (.woff2)
2. Configure font weights:
   • Regular (400)
   • Medium (500)
   • Semibold (600)
   • Bold (700)
3. Preview text rendering

Custom Domain

Domain Setup

Use your own domain for TwinEdge:

https://platform.yourcompany.com

Instead of:

https://yourcompany.twinedgeai.com

Configuration Steps

1. Go to Settings → Branding → Domain

2. Enter your custom domain

3. Add DNS records:

   Type: CNAME
   Name: platform
   Value: custom.twinedgeai.com

4. Wait for DNS propagation (up to 48 hours)

5. Request SSL certificate generation

6. Activate custom domain

SSL Certificate

TwinEdge automatically:

• Generates Let's Encrypt certificate
• Renews certificate automatically
• Handles HTTPS redirect

Multiple Domains (Optional)

For global deployments:

• platform.us.yourcompany.com
• platform.eu.yourcompany.com

Contact support for multi-domain setup.

Login Page

Customization Options

Element	Customizable
Logo	Yes
Background	Yes (image or color)
Welcome text	Yes
Footer links	Yes
SSO buttons	Yes (text and order)

Login Page Editor

1. Go to Settings → Branding → Login Page
2. Configure:
   • Background: Upload image or set color
   • Welcome Title: e.g., "Welcome to ACME IoT"
   • Welcome Subtitle: e.g., "Sign in to continue"
   • Show "Powered by TwinEdge": Toggle
3. Preview changes
4. Click Save

Custom Login CSS

For advanced customization:

/* Login page custom styles */
.login-container {
  background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
}

.login-card {
  border-radius: 16px;
  box-shadow: 0 25px 50px rgba(0, 0, 0, 0.5);
}

.login-button-primary {
  background: #00E5BF;
  border-radius: 8px;
}

Email Templates

Customizable Emails

Email	Customizable Elements
Welcome	Logo, colors, text
Password Reset	Logo, colors, text
Alert Notifications	Logo, colors, layout
Reports	Logo, header, footer
Invitations	Logo, colors, text

Template Editor

1. Go to Settings → Branding → Email Templates
2. Select template to edit
3. Customize:
   • Header with logo
   • Brand colors
   • Footer text and links
   • Custom content sections
4. Send test email
5. Save changes

Email Sender Configuration

Configure "From" address:

From: Industrial IoT Platform <alerts@yourcompany.com>
Reply-To: support@yourcompany.com

Requirements:

• Verified domain ownership
• SPF/DKIM records configured
• DMARC policy set

Application Text

Customizable Strings

Change default text throughout the application:

Default	Custom Example
"TwinEdge"	"ACME IoT Platform"
"Dashboard"	"Control Center"
"Assets"	"Equipment"
"Data Sources"	"Connections"

String Editor

1. Go to Settings → Branding → Custom Text
2. Search for strings to customize
3. Enter replacement text
4. Preview in context
5. Save changes

Footer & Legal

Footer Configuration

Customize footer links:

{
  "footer": {
    "links": [
      {"label": "Terms of Service", "url": "https://yourcompany.com/terms"},
      {"label": "Privacy Policy", "url": "https://yourcompany.com/privacy"},
      {"label": "Support", "url": "https://support.yourcompany.com"}
    ],
    "copyright": "© 2026 ACME Corporation. All rights reserved.",
    "show_powered_by": false
  }
}

Legal Documents

Host your own legal documents:

1. Terms of Service: Link to your terms
2. Privacy Policy: Link to your privacy policy
3. Cookie Policy: Link to cookie policy
4. Acceptable Use: Link to AUP

Mobile App (PWA)

PWA Manifest

Customize the installable web app:

{
  "name": "ACME IoT Platform",
  "short_name": "ACME IoT",
  "description": "Industrial IoT monitoring platform",
  "theme_color": "#00E5BF",
  "background_color": "#0B0F14"
}

App Icons

Upload icons for mobile:

• 192x192 px (required)
• 512x512 px (required)
• 180x180 px (iOS)

API Configuration

Branding API

# Get current branding
GET /api/v1/branding
Authorization: Bearer YOUR_API_KEY

# Update branding
PUT /api/v1/branding
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "colors": {
    "primary": "#FF6B00",
    "background": "#0D1117"
  },
  "logo_url": "https://yourcompany.com/logo.svg",
  "company_name": "ACME Corporation"
}

Upload Assets

POST /api/v1/branding/assets
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

file=@logo.svg
type=logo

Testing & Preview

Preview Mode

Test branding changes before going live:

1. Make changes in branding settings
2. Click Preview (opens in new tab)
3. Test all pages and components
4. Make adjustments
5. Click Publish when ready

Staging Environment

Enterprise plans include a staging environment:

https://staging.yourcompany.twinedgeai.com

Test all changes in staging first.

Best Practices

Brand Consistency

1. Use official brand colors
2. Follow brand guidelines
3. Ensure logo quality
4. Test across devices

Accessibility

1. Ensure color contrast (WCAG 2.1 AA)
2. Test with screen readers
3. Verify keyboard navigation
4. Check mobile usability

Performance

1. Optimize image sizes
2. Use SVG for logos
3. Minimize custom CSS
4. Test page load times

Troubleshooting

Logo Not Displaying

• Check file format (PNG/SVG)
• Verify file size limits
• Clear browser cache
• Check CORS settings

Colors Not Applied

• Clear browser cache
• Check CSS specificity
• Verify hex color format
• Test in incognito mode

Custom Domain Issues

• Verify DNS records
• Check SSL certificate
• Allow 48h for DNS propagation
• Contact support if persists

Next Steps

• SSO Configuration - Customize login methods
• RBAC & Permissions - Control access
• Audit Logging - Track changes