Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/javierpr0/Notchly/llms.txt

Use this file to discover all available pages before exploring further.

Notchly ships with 10 built-in color themes. Changing the theme colors the terminal contents — background, foreground, ANSI colors, cursor, and selection — and the entire app chrome: tabs, panel header, dividers, and control buttons all update to match. Everything you see outside the terminal content itself derives its palette from the active theme, so the whole app feels unified regardless of which theme you pick.

Available themes

Each theme is identified by a stable string ID that Notchly uses to persist your selection across launches.
ThemeIDBackgroundStyle
Defaultdefault#1A1A1ADark neutral
Draculadracula#282A36Dark purple
One Darkone-dark#282C34Dark blue-grey
Solarized Darksolarized-dark#002B36Dark teal
Solarized Lightsolarized-light#FDF6E3Light warm
Nordnord#2E3440Dark arctic blue
Monokaimonokai#272822Dark warm
Tokyo Nighttokyo-night#1A1B26Dark deep blue
Gruvbox Darkgruvbox-dark#282828Dark earthy
Catppuccin Mochacatppuccin-mocha#1E1E2EDark lavender
Solarized Light is currently the only light theme. All other themes use dark backgrounds. Light-theme support for chrome elements (tabs, header) is derived from the same formula as dark themes — the panel background blends slightly toward white from the theme’s base color.

Changing the theme

1

Open Settings

Click the gear icon (⚙) in the panel header to open the Settings popover.
2

Select a theme

Choose any theme from the Theme selector. The change takes effect immediately — the terminal content and all chrome update in real time without restarting any sessions.
3

Close the popover

Click anywhere outside the popover to dismiss it. Your selection is saved automatically and restored on the next launch.

How themes apply to chrome

Notchly derives a set of chrome colors from each theme’s base values. These derived colors drive everything outside the terminal viewport: the panel background, tab labels, dividers, and interactive controls.
The panel background color. Computed by blending the theme’s background color with 10% white, producing a surface that reads as slightly lighter than the terminal area itself. This creates a subtle visual separation between the terminal content and the surrounding chrome without introducing a jarring border.
chromeBackground = background.blended(withFraction: 0.10, of: .white)
A secondary panel surface, used for nested or recessed areas. Blends the theme’s background with only 5% white — sitting between the raw terminal background and chromeBackground.
chromeBackgroundDarker = background.blended(withFraction: 0.05, of: .white)
The primary text and icon color for the tab bar, header controls, and button labels. Taken directly from the theme’s foreground color, ensuring legibility against the chrome background at the same contrast ratio as terminal text.
A muted variant of the foreground color used for secondary labels, inactive tab names, and supplementary UI text. Rendered at 50% opacity over the chrome background.
chromeSecondary = foreground.withAlphaComponent(0.5)
The highlight color for active tabs, focus rings, and interactive accents. Taken directly from the theme’s cursor color, which each theme author has tuned for high contrast against that theme’s background.
A very subtle line color used for the dividers between split panes and between the tab bar and terminal area. Rendered at 12% opacity of the foreground color, so it’s perceptible but never distracting.
chromeDivider = foreground.withAlphaComponent(0.12)

Font size

The terminal font size can be adjusted at any time without restarting sessions. Changes apply immediately to all open terminal panes.

Keyboard shortcuts

ShortcutAction
Cmd =Increase font size
Cmd -Decrease font size
Cmd 0Reset font size to default

Settings panel

Font size is also accessible from the gear icon → Font Size section in the Settings popover, where you can use the + and buttons or type a value directly. The reset button in that section returns the font size to the app default.

Build docs developers (and LLMs) love