# Whitelabelling Buzzy

Buzzy supports extensive whitelabelling capabilities that allow organizations to customize the platform's appearance and branding to match their corporate identity. This guide covers all available customization options.

### Table of contents

1. [Branding overview](#branding-overview)
2. [Logo customization](#logo-customization)
3. [Color schemes and themes](#color-schemes-and-themes)
4. [Custom domains](#custom-domains)
5. [Email customization](#email-customization)
6. [Mobile app branding](#mobile-app-branding)

***

### Branding overview

Buzzy's whitelabelling system allows complete customization of:

* **Visual Identity**: Logos, colors, and themes
* **Domain Names**: Custom domains and subdomains
* **Email Templates**: Branded email communications
* **Mobile Apps**: Custom branded mobile applications
* **Terminology**: Custom naming for platform concepts
* **Welcome Screens**: Custom onboarding experiences

### Logo customization

#### Main Application Logo

Configure the primary logo displayed in the application header:

```json
"BUZZY_CUSTOM": {
  "LOGO_MAIN": "https://yourdomain.com/logo-main.png"
}
```

**Requirements:**

* Format: PNG with transparent background
* Dimensions: Optimized for 192x28 pixel area
* Style: Light colors for dark header background
* Orientation: Horizontal format recommended

#### Email Logo

Configure the logo used in system emails:

```json
"BUZZY_CUSTOM": {
  "LOGO_MAIL": "https://yourdomain.com/logo-email.png",
  "LOGO_MAIL_WIDTH": "240",
  "LOGO_MAIL_HEIGHT": "60"
}
```

**Requirements:**

* Format: PNG, JPG, or GIF
* Background: White or transparent
* Style: Dark colors for light email background
* Dimensions: Specify exact width and height

#### Favicon Configuration

Set custom favicon for browser tabs:

```json
"BUZZY_CUSTOM": {
  "FAVICON": "<link rel=\"icon\" type=\"image/png\" href=\"https://yourdomain.com/favicon.png\">"
}
```

### Color schemes and themes

#### Primary Branding Colors

While Buzzy doesn't expose direct color customization in settings, you can influence the visual appearance through:

* **Logo Design**: Use brand colors in your logos
* **Custom CSS**: Inject custom styles through configuration
* **Theme Selection**: Choose from available theme options

#### Custom CSS Integration

For advanced customization, custom CSS can be injected:

```json
"BUZZY_CUSTOM": {
  "CUSTOM_CSS": "https://yourdomain.com/custom-styles.css"
}
```

### Custom domains

#### Domain Configuration

Set up custom domains for your Buzzy instance:

1. **DNS Configuration**: Point your domain to Buzzy servers
2. **SSL Certificates**: Configure SSL for your custom domain
3. **Load Balancer**: Update load balancer configuration
4. **Application Settings**: Update ROOT\_URL in configuration

#### Subdomain Strategy

Organize services using subdomains:

* **Main App**: `app.yourdomain.com`
* **API**: `api.yourdomain.com`
* **Files**: `files.yourdomain.com`
* **Logging**: `logs.yourdomain.com`

### Email customization

#### Email Branding

Customize email appearance and content:

```json
"BUZZY_CUSTOM": {
  "EMAIL_FOOTER": "© 2024 Your Organization. All rights reserved.",
  "PROMO": "Powered by Your Organization's Innovation Platform",
  "PROMO_URL": "https://yourdomain.com/about"
}
```

#### Email Addresses

Configure sender addresses:

```json
"BUZZY_CUSTOM": {
  "BUZZY_DONOTREPLY_EMAIL": "noreply@yourdomain.com",
  "SUPPORT_EMAIL": "support@yourdomain.com"
}
```

#### Custom Email Messages

Customize invitation and notification messages:

```json
"BUZZY_CUSTOM": {
  "INVITE_TEAM_MESSAGE": "Welcome to our innovation platform!",
  "INVITE_TEAM_BUTTON_TEXT": "Join Our Platform",
  "INVITE_BUZZ_TEXT": "has shared something exciting with you",
  "INVITE_CLICK_TO_VIEW_TEXT": "Click here to view and collaborate"
}
```

### Mobile app branding

#### App Store Links

Configure links to your branded mobile apps:

```json
"BUZZY_CUSTOM": {
  "APP_URL_IOS": "https://apps.apple.com/app/your-app/id123456789",
  "APP_URL_ANDROID": "https://play.google.com/store/apps/details?id=com.yourorg.app"
}
```

#### App Naming

Customize terminology used throughout the platform:

```json
"BUZZY_CUSTOM": {
  "NAME": "Your Platform Name",
  "NAME_BUZZ": "Project",
  "NAME_BUZZES": "Projects"
}
```

#### Welcome Experience

Customize the onboarding experience:

```json
"BUZZY_CUSTOM": {
  "WELCOME_IMAGE": "https://yourdomain.com/welcome-background.jpg",
  "SPLASH_IMAGE": "https://yourdomain.com/splash-screen.jpg"
}
```

#### Navigation Customization

Customize navigation elements:

```json
"BUZZY_CUSTOM": {
  "CUSTOM_NAV": {
    "help_url": "https://yourdomain.com/help",
    "about_url": "https://yourdomain.com/about",
    "contact_url": "https://yourdomain.com/contact"
  }
}
```

### Implementation example

Complete whitelabelling configuration example:

```json
{
  "public": {
    "BUZZY_CUSTOM": {
      "NAME": "Innovation Hub",
      "NAME_BUZZ": "Innovation",
      "NAME_BUZZES": "Innovations",
      "LOGO_MAIN": "https://cdn.yourorg.com/logo-main.png",
      "LOGO_MAIL": "https://cdn.yourorg.com/logo-email.png",
      "LOGO_MAIL_WIDTH": "200",
      "LOGO_MAIL_HEIGHT": "50",
      "EMAIL_FOOTER": "© 2024 Your Organization. Driving Innovation Forward.",
      "PROMO": "Powered by Your Organization's Innovation Platform",
      "PROMO_URL": "https://yourorg.com/innovation",
      "APP_URL_IOS": "https://apps.apple.com/app/innovation-hub/id123456789",
      "APP_URL_ANDROID": "https://play.google.com/store/apps/details?id=com.yourorg.innovation",
      "WELCOME_IMAGE": "https://cdn.yourorg.com/welcome-bg.jpg",
      "SUPPORT_EMAIL": "innovation-support@yourorg.com",
      "INVITE_TEAM_MESSAGE": "Join our innovation community!",
      "INVITE_TEAM_BUTTON_TEXT": "Join Innovation Hub",
      "CUSTOM_NAV": {
        "help_url": "https://yourorg.com/innovation/help",
        "about_url": "https://yourorg.com/innovation/about"
      }
    },
    "BUZZY_DONOTREPLY_EMAIL": "noreply@yourorg.com"
  }
}
```

***