# 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"
  }
}
```

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buzzy.buzz/advanced-deployment-settings/installation/whitelabelling-buzzy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.