Skip to content

docs: add pane synchronization status indicator - #595

Open
aarongxa wants to merge 1 commit into
catppuccin:mainfrom
aarongxa:feature/pane-sync-indicator
Open

aarongxa wants to merge 1 commit into
catppuccin:mainfrom
aarongxa:feature/pane-sync-indicator

Conversation

@aarongxa

Copy link
Copy Markdown

Description

Add documentation for a conditional pane sync indicator in the status line, showing how to use tmux's #{?pane_synchronized,...} format conditional with catppuccin theming.

What's documented

  • Icon: nf-md-sync (󰓦) from Nerd Fonts
  • Color: catppuccin mauve (#{@thm_mauve})
  • Pattern: Use a user option variable (@sync_on) to avoid nesting #[...] style directives inside #{?...} conditionals
  • Behavior: Badge appears only when panes are synchronized (prefix a), disappears when unsynced

Where

Added as a new section at the end of docs/tutorials/02-custom-status.md, since it's a user-defined status line pattern that leverages catppuccin theme variables.

Add documentation for a conditional pane sync indicator in the status
line. Uses tmux's #{?pane_synchronized,...} format conditional with
catppuccin mauve coloring and nf-md-sync icon (󰓦).

The badge appears only when panes are synchronized (prefix a) and
disappears when unsynced — no status bar clutter.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant