Skip to main content

Module aurora

Module aurora 

Source
Expand description

Aurora color palette — ANSI 256 constants for log formatting.

§CUSTOMIZE: Why a separate color module?

These constants are the single source of truth for color values across ALL rendering surfaces in this server:

  • Console log formatting (formatter.rs)
  • CLI output theming (if any)
  • Future UI surfaces

Do not inline ANSI codes elsewhere. Always reference aurora::CONSTANT. This makes palette changes a one-line edit.

§CUSTOMIZE: Copy these constants EXACTLY

The values below match lab/crates/lab/src/output/theme.rs exactly. When adapting Soma for your service, copy this file unchanged. The aurora palette is shared across the entire rmcp server family: unraid-rmcp, gotify-rmcp, unifi-rmcp, tailscale-rmcp, apprise-rmcp, and soma.

§ANSI 256 vs TrueColor

The log formatter uses ANSI 256 (not TrueColor) because:

  • ANSI 256 is supported by virtually every terminal emulator
  • Docker’s docker compose logs strips TrueColor but keeps ANSI 256
  • The console crate used in lab only supports ANSI 256

The RGB values shown in comments are the closest-matching TrueColor equivalents for documentation purposes only.

Constants§

ACCENT_PRIMARY
Bright blue — used for primary action/route/tool identifiers.
ERROR
Muted red — used for errors and HTTP 5xx status codes.
SERVICE_NAME
Pink — used for service names, first token of log messages.
SUCCESS
Teal — used for success states and HTTP 2xx status codes.
TEXT_MUTED
Light grey — used for secondary metadata and muted text.
WARN
Amber — used for warnings and HTTP 4xx status codes.