Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Theming

Fern Shell uses a three-tier design token system for consistent theming.

Token Architecture

Tier 1: Primitives (built-in palettes)
  ↓
Tier 2: Semantic Tokens (configurable)
  ↓
Tier 3: Component Tokens (internal)

Tier 1: Primitives

Built-in color palettes that you don't configure directly:

Dark Palette (Catppuccin Mocha)

  • Base: #1e1e2e
  • Surface: #313244
  • Text: #cdd6f4

Light Palette (Catppuccin Latte)

  • Base: #eff1f5
  • Surface: #e6e9ef
  • Text: #4c4f69

Tier 2: Semantic Tokens

These are what you configure in config.toml:

[appearance]
theme = "dark"      # Selects the palette
accent = "#89b4fa"  # Override the accent color

Tier 3: Component Tokens

Internal mappings that components use. You don't configure these directly:

  • barBackground → background
  • moduleBackground → surface
  • textPrimary → foreground

Color Reference

TokenDarkLightUsage
background#1e1e2e#eff1f5Bar background
surface#313244#e6e9efModule backgrounds
foreground#cdd6f4#4c4f69Primary text
accent#89b4fa#1e66f5Active states

Fonts

[appearance]
font_family = "Inter"                    # UI text
font_mono = "JetBrainsMono Nerd Font"    # Monospace
font_icon = "Material Symbols Rounded"   # Icons

Custom Accents

Popular accent colors from Catppuccin:

NameHexPreview
Blue#89b4faDefault
Mauve#cba6f7Purple
Pink#f5c2e7Light pink
Teal#94e2d5Cyan-ish
Green#a6e3a1Soft green