Skip to content

Theming

Customize Canopy's appearance to match your preferences.

Color Mode

ModeDescription
LightLight background, dark text
DarkDark background, light text
SystemFollows OS preference

Toggle via Settings > Appearance.

Accent Colors

Customize the app's accent color used for:

  • Active states
  • Links
  • Progress bars
  • Selected items
  • Buttons
ColorDescription
Frost (default)Cool blue-grey, professional
IceLight teal, calm
AuroraSoft green, nature
LavenderGentle purple, creative
SandWarm orange, energetic
RoseBold pink, attention

Settings Menu

Atlaskit Integration

Canopy uses Atlassian Design System tokens for Jira-consistent theming:

  • Status colors match Jira categories
  • Priority icons use Jira styling
  • Issue type icons are consistent with Jira

This ensures visual consistency when working between Canopy and Jira.

Settings Persistence

Theme settings are persisted to localStorage:

SettingStorage Key
Color Modecanopy_theme
Accent Colorcanopy_color_theme
Display Densitycanopy_display_density
Date Formatcanopy_date_format

Settings sync across browser tabs and persist after closing.

Display Density

Adjust spacing between elements:

ModeDescription
ComfortableMore whitespace, larger touch targets
CompactReduced spacing, more content visible

Compact mode is useful for:

  • Smaller screens
  • Viewing large issue trees
  • Quick scanning

Keyboard Shortcuts

No keyboard shortcuts for theming. Use the settings menu.

Exporting Theme Settings

Theme preferences are included in the configuration export:

  1. Click Settings > Data > Export Configuration
  2. The JSON file includes:
    • theme (light/dark/auto)
    • colorTheme (frost/ice/aurora/lavender/sand/rose)
    • displayDensity (comfortable/compact)
    • dateFormat (absolute/relative)

Import this file on another device to restore your preferences.

Released under the MIT License.