Creating a Custom Theme
You can customize the look of the Skillz UI using our "Custom Theme" feature so that it feels native to your game. Although we recommend customizing your theme, it is not mandatory, and you may opt to stick with the default.
You can access the theme editor from two places:
- For active games: click “Edit Game” from your Developer Console home page and go to "Theme"
- For in progress games: click "Continue Integration" from your Developer Console Home Page and go to "SDK Theme"
Theme Attribute Mappings
The following images illustrate what each theme attribute maps to in the Skillz UI:
Downloading Your Theme
After saving your theme, the page will create a theme.json for you to download. Do not rename this file!
Installing Your Theme
Next, you’ll open your game’s XCode project and find the file Skillz.framework
Select the option "Show in Finder."
Next, find the old JSON file within the folder and replace it with the file theme.json that you’ve just downloaded
Update your app's call to initWithGameId to have withEnvironment:SkillzSandbox. Now you should be able to open your app, launch Skillz and take a look at your new theme within Sandbox. To ensure you are viewing the latest theme, force quit (double-tap home button and swipe away) and restart your game after each change.
NOTE
When you update the Skillz SDK it involves overwriting the old version of
Skillz.framework. When you upgrade Skillz make sure you also replace yourtheme.json
Downloading Your Theme
After saving your theme, the page will create a custom_theme.json for you to download. Do not rename this file!
Installing Your Theme
Create an assets folder in Android Studio if your project does not already have one:
Then press the FINISH button on the subsequent dialog that appears:
Now select the assets folder you just created in your project’s Android view, and right click it to bring up a contextual menu:
Choose "Reveal in Finder" (or "Reveal in Explorer" on Windows). This will open the corresponding assets folder on your hard drive.
Now locate the custom_theme.json file that you downloaded and drag it into the assets folder on your hard drive:
Finally, confirm that the custom_theme.json file has now been added to your Android Studio project:
Update your app's Manifest to have skillz_production set to false. Now you should be able to open your app, launch Skillz and take a look at your new theme within Sandbox. To ensure you are viewing the latest theme, force quit (double-tap home button and swipe away) and restart your game after each change.
Themes cannot be installed directly from your Unity project.
Android
When building your project select Export Project. Using the generated Android Studio project, follow the instructions on the Android tab on this page.
iOS
When building your Unity iOS game, Unity will automatically generate an Xcode project for you. Using the generated Xcode project, follow the instructions on the iOS tab on this page.
Request to sync your theme to production
Once you’re happy with your theme on sandbox, go to your game's Theme page and click "Request Sync" (pictured below). Our integration team will email you to let you know when your theme has been synced to your production game.
