FullFran/nyxterm / .agents/skills/theming
theming
UnverifiedTokyo 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.
| Token | Hex | Use |
|---|---|---|
bg | #1a1b26 | window/pane background |
bg-alt | #16161e | sidebar, popover |
fg | #a9b1d6 | default text |
fg-dim | #787c99 | secondary text, comments |
accent | #7aa2f7 | primary accent (blue), cursor |
cyan | #7dcfff | strings, links |
green | #9ece6a | success, additions |
red | #f7768e | error, deletions |
yellow | #e0af68 | warning |
purple | #bb9af7 | keywords, special |
selection | #283457 | selection background |
ANSI palette must match Tokyo Night Night (see Ghostty's built-in theme).
Rules
- No hardcoded colors in components. Always reference theme tokens via CSS custom properties (
var(--nyx-accent)) or a typed theme object. - Theme is emitted, not computed. Rust emits the palette to the frontend on theme change; frontend listens and updates CSS vars.
- 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 318k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |