Skip to content

FullFran/nyxterm / .agents/skills/theming

theming

Unverified

Tokyo Night palette, theme API, no hardcoded colors. Load when touching CSS, xterm theme config, or any color-related code.

Theming

Default: Tokyo Night (Night variant)

Canonical palette. Source-of-truth lives in src-tauri/src/modules/theme/palette.rs (TBD in Phase 1). Everything else reads from there.

TokenHexUse
bg#1a1b26window/pane background
bg-alt#16161esidebar, popover
fg#a9b1d6default text
fg-dim#787c99secondary text, comments
accent#7aa2f7primary accent (blue), cursor
cyan#7dcfffstrings, links
green#9ece6asuccess, additions
red#f7768eerror, deletions
yellow#e0af68warning
purple#bb9af7keywords, special
selection#283457selection background

ANSI palette must match Tokyo Night Night (see Ghostty's built-in theme).

Rules

  1. No hardcoded colors in components. Always reference theme tokens via CSS custom properties (var(--nyx-accent)) or a typed theme object.
  2. Theme is emitted, not computed. Rust emits the palette to the frontend on theme change; frontend listens and updates CSS vars.
  3. Sister tools read from us. Theme API exports JSON/TOML fragments for fzf, bat, lazygit, btop, starship (or our prompt). User picks once, theme propagates everywhere.

Theme API shape (draft)

struct Theme {
    name: String,
    palette: Palette,
    ansi: [Color; 16],
}

#[tauri::command] fn theme_get() -> Theme
#[tauri::command] fn theme_set(name: String)
#[tauri::command] fn theme_export(target: ExportTarget) -> String

Targets: fzf, bat, lazygit, btop, delta, starship, kitty-conf (compat).

Frontend

:root {
  --nyx-bg: #1a1b26;
  --nyx-fg: #a9b1d6;
  --nyx-accent: #7aa2f7;
  /* ... */
}

CSS vars set on :root by a useTheme() hook listening to the Rust event. Components only use vars.

xterm.js terminal theme

term.options.theme = {
  background: cssVar('--nyx-bg'),
  foreground: cssVar('--nyx-fg'),
  cursor: cssVar('--nyx-accent'),
  selectionBackground: cssVar('--nyx-selection'),
  // ... 16 ANSI colors from theme.ansi
};

Re-apply on theme change.

Transparency / aesthetic

Default opacity: 0.95. Unfocused-split opacity: 0.9 (dim inactive panes, Ghostty pattern). CSS-driven, GPU-accelerated.

What we do NOT support (yet)

  • Live theme reload from the OS (light/dark). Phase 2.
  • User-authored themes. Phase 1.5+ via Settings UI.
  • Per-pane themes. Probably never — clutter.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall