Themes

CTStyle styles the SDK screens that host the web booking flow and Grid View details, such as the navigation bar, buttons and dialogs. By default, the colour for text and icons on colour backgrounds are white. If your brand colours are a bright colour (high luminosity), it’s recommended you change to a dark text theme for legibility of text and colours.

If you do not wish to set the four optional properties manually, the CarTrawler SDK will create the colours for you (Note: this is currently only an iOS feature within the SDK)

Colours and fonts inside the web booking flow and the Grid View are part of your partner configuration and are managed by CarTrawler. Please contact your CarTrawler representative to change them.

Creating a CTStyle

Theming is achieved by creating a CTStyle object and initialising the SDK with it.

CTStyle has the following properties:

• [Required] theme
• [Required] primaryColor
• primaryLightColor
• primaryDarkColor
• ctaColor
• ctaFontColor
• secondaryCtaColor
• secondaryCtaFontColor

let style = CTStyle(theme: .dark,  // .dark or .light
           primaryColor: UIColor.gray)
style.primaryLightColor = UIColor.lightGray // Optional, default light generated based on primary color
style.primaryDarkColor = UIColor.darkGray // Optional, default dark generated based on primary color
style.ctaColor = UIColor.blue // Optional, default iOS blue RGB(0,122,255)
style.ctaFontColor = UIColor.white  // Optional, default white or dark based on theme
style.secondaryCtaColor = UIColor.black // Optional, default primary color
style.secondaryCtaFontColor = UIColor.white // Optional, default white or dark based on theme

Setting a Custom Font

style.regularFont = UIFont(name: "myCustomFont", size: 14)!
style.boldFont = UIFont(name: "myCustomFont", size: 14)!
style.italicFont = UIFont(name: "myCustomFont", size: 14)!

Please ensure any custom fonts used are included in your main bundle.

SDK Initialisation

After CTStyle is configured, it must be passed into the SDK during initialisation in your AppDelegate:

// In application(_:didFinishLaunchingWithOptions:)
CarTrawlerSDK.sharedInstance().initialiseSDK(with: style,
                               customParameters: nil,
                               production: false)