Skip to main content

Appearance

+[Bugsee getAppearance] returns the shared BugseeTheme. Set its properties to change the colors and placeholder texts of the report dialog and of the feedback screen. A property you leave unset keeps its default, which depends on the style.

BugseeTheme *theme = [Bugsee getAppearance];
theme.reportBackgroundColor = [UIColor darkGrayColor];
theme.reportNavigationBarColor = [UIColor blackColor];
theme.reportTextColor = [UIColor whiteColor];

theme.reportSummaryPlaceholder = @"What happened? Briefly";
theme.reportDescriptionPlaceholder = @"Describe what you did and what went wrong";

Report dialog​

PropertyWhat it sets
reportBackgroundColorBackground of the report dialog.
reportNavigationBarColorBackground of the navigation bar.
reportCellBackgroundColorBackground of the table cells.
reportTextColorText color of the labels.
reportPlaceholderColorPlaceholder color of the input fields.
reportVersionColorText color of the version label.
reportSummaryPlaceholderPlaceholder of the Summary field.
reportDescriptionPlaceholderPlaceholder of the Description field.
reportEmailPlaceholderPlaceholder of the Email field.
reportLabelsPlaceholderPlaceholder of the Labels field.
reportCloseButtonColorDeprecated and not applied: the report dialog uses the system Cancel button.
reportSendButtonColorDeprecated and not applied: the report dialog uses the system Done button.

Which fields the dialog shows and requires is set with launch options, such as BugseeOptionReportingUILabelsEnabled and BugseeOptionReportingUIEmailRequired; see Configuration.

Feedback screen​

The feedback screen ships in the separate BugseeFeedback package. It is drawn in system colors and reads these theme properties:

PropertyWhat it sets
feedbackBackgroundColorBackground of the chat. Defaults to the system background. A fixed (not dynamic) color also picks the light or dark interface style of the chat, so its system-colored text stays readable.
feedbackEmailBackgroundColorBackground of the screen that asks for the user's email before the chat.
feedbackEmailContinueActiveColorBackground of the Continue button once the email is valid.
feedbackEmailContinueNotActiveColorBackground of the Continue button while the email is not valid.
feedbackEmailSkipColorText color of the Skip button.

The other feedback* properties of BugseeTheme — feedbackBarsColor, feedbackNavigationBarColor, feedbackTitleTextColor, feedbackCloseButtonColor, feedbackIncomingBubbleColor, feedbackOutgoingBubbleColor, feedbackIncomingTextColor, feedbackOutgoingTextColor, feedbackInputBackgroundColor and feedbackInputTextColor — still compile, but the 7.x feedback screen does not apply them.

Style​

The style picks the default colors of the report dialog. Set it with the BugseeOptionReportingUIStyle launch option, or the bugseeStyle property of BugseeOptions:

ValueDefault colors
BugseeStyleSystemSystem colors, which follow the device's light or dark mode. The default.
BugseeStyleLightA fixed light palette.
BugseeStyleDuskA fixed dark palette.
BugseeStyleBasedOnStatusBarDusk when the status bar shows light content, Light otherwise.
BugseeOptions *options = [BugseeOptions defaultOptions];
options.bugseeStyle = BugseeStyleDusk;

[Bugsee launchWithToken:@"<your_app_token>" options:options];

Bugsee applies the option to the theme each time the report dialog opens, so set the style through the option rather than through the theme's style property. Colors you set on the theme take precedence over the style's defaults.

Found an issue, typo, or wrong statement on this page? Report it now →