FullFran/nyxterm / .agents/skills/theming
theming
VerifiedTokyo Night palette, theme API, no hardcoded colors. Load when touching CSS, xterm theme config, or any color-related code.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
SKILL.md
View on GitHub---
name: theming
description: Tokyo Night palette, theme API, no hardcoded colors. Load when touching CSS, xterm theme config, or any color-related code.
triggers:
- theme
- color
- palette
- "tokyo night"
- css
- "ansi colors"
---
# 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
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)
```rust
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
```css
: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
```ts
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: 322k | Updated | Claude CodeCodex | Verified | 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: 198k | 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: 198k | 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: 198k | Updated | Claude CodeCodex | Verified | Install |