styles

styles Package

The styles package provides centralized color constants, adaptive color variables, border definitions, and pre-configured lipgloss styles for consistent terminal output across the codebase.

Overview

All colors use compat.AdaptiveColor to automatically choose between light and dark variants based on the terminal's background. The dark palette is inspired by the Dracula theme; the light palette uses darker, more saturated colors for good contrast on light backgrounds.

Public API

The styles package exports the following:

Adaptive Color Variables

These variables provide compat.AdaptiveColor values that auto-select the correct shade at render time:

Border Definitions

Pre-configured Styles

These lipgloss.Style values are ready to use directly:

Usage Examples

import "github.com/github/gh-aw/pkg/styles"

// Use pre-configured styles
fmt.Println(styles.Error.Render("Something went wrong"))
fmt.Println(styles.Success.Render("Operation completed"))
fmt.Println(styles.Command.Render("gh aw compile"))

// Use adaptive colors for custom styles
customStyle := lipgloss.NewStyle().
    Foreground(styles.ColorInfo).
    Bold(true)
fmt.Println(customStyle.Render("Custom styled text"))

Huh Theme

The package also exports HuhTheme — a huh.ThemeFunc that applies the same Dracula-inspired color palette to interactive forms rendered with the huh library.

import "github.com/github/gh-aw/pkg/styles"

form := huh.NewForm(...).WithTheme(styles.HuhTheme)

Design Notes

• Colors are defined with both light and dark hex constants (hexColor*Light, hexColor*Dark) so tests can assert exact color values without depending on the lipgloss type system.
• The package uses charm.land/lipgloss/v2 and charm.land/lipgloss/v2/compat for adaptive color support.
• For visual examples and detailed usage guidelines, see scratchpad/styles-guide.md.
• All * styles export pre-configured lipgloss.Style values (not functions), so they can be used with method chaining: styles.Error.Copy().Underline(true).

This specification is automatically maintained by the spec-extractor workflow.