Getting Started

Installation & Setup

Requirements

• Unity 2022.3 or newer
• Dependencies (installed automatically):
  • com.unity.2d.sprite 1.0.0
  • com.unity.textmeshpro 3.0.6
  • com.unity.ugui 1.0.0
  • com.unity.modules.ui 1.0.0
  • com.unity.modules.uielements 1.0.0
  • com.unity.modules.imgui 1.0.0
  • com.unity.modules.jsonserialize 1.0.0

Installation

Option 1 — Installer (.unitypackage)

1. Download Unity-Theme-Installer.unitypackage
2. Import into your Unity project:
   • Double-click the file — Unity will open it automatically
   • Or in Unity: Assets > Import Package > Custom Package, then select the file
3. The installer will set up the package via UPM automatically

Option 2 — OpenUPM CLI

1. Install OpenUPM-CLI if you haven't already
2. Open a terminal in your Unity project folder
3. Run:

openupm add extensions.unity.theme

Option 3 — Unity Asset Store

1. Open the Unity Asset Store page
2. Add to your assets and import via the Package Manager

First Steps

1. Open the Theme Editor Window

Go to Window > Unity-Theme to open the editor window.

2. Create a Theme

In the editor window, click the "+" button to add a new theme. Give it a name like "Light" or "Dark".

3. Add Colors

Add named colors to your palette. Each color gets a unique GUID, so you can rename colors later without breaking references.

For a quick start, the default database comes with 23 Material Design 3 colors across Light and Dark themes.

4. Add a Color Binder to a GameObject

On any GameObject with a visual component (Image, TextMeshPro, SpriteRenderer, etc.):

1. Click Add Component
2. Search for "Theme/" to see all available binders
3. Select the appropriate binder (e.g., "Image Color Binder")
4. In the binder's inspector, select which named color it should use

The component will immediately update to show the current theme's color. Switch themes and watch all bound components update instantly.

5. Switch Themes

You can switch themes:

• In the Editor: Use the theme dropdown in the Unity-Theme window
• At Runtime via C#:

using Unity.Theme;

// By name
Theme.Instance.CurrentThemeName = "Dark";

// By index
Theme.Instance.CurrentThemeIndex = 1;

Next Steps

• Learn about the Editor Window in detail
• See all Built-in Color Binders
• Create Custom Binders for your own components
• Explore the full C# API