OpenParable
Skip to content
← Back to skills

Change Theme

Design
change-theme

Change Theme is an Agent Skill for design published in the pagezero-dev/pagezero repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Updates the shadcn/ui theme by editing OKLCH CSS custom properties in apps/core/styles/tailwind.css. Use when the user wants to change colors, theme appearance, or match a brand palette.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/pagezero-dev/pagezero/blob/HEAD/.agents/skills/change-theme/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/change-theme, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Change Theme

Modify the shadcn/ui theme by updating CSS custom properties in apps/core/styles/tailwind.css.

Gather Information

Ask the user in a single question:

What theme style would you like? (e.g., "blue primary color", "warm and rounded", "minimal with sharp corners", or a specific hex color to match)

Theme File Location

The theme is defined in apps/core/styles/tailwind.css with CSS custom properties using the OKLCH color space.

Theme Structure

The file contains three main sections:

  1. :root - Light mode colors (lines 73-106)
  2. .dark - Dark mode colors (lines 110-142)
  3. @theme inline - Tailwind color mappings (lines 33-69)

Available Color Variables

VariablePurpose
--backgroundPage background
--foregroundDefault text color
--cardCard backgrounds
--card-foregroundCard text
--popoverPopover/dropdown backgrounds
--popover-foregroundPopover text
--primaryPrimary brand color (buttons, links)
--primary-foregroundText on primary color
--secondarySecondary actions
--secondary-foregroundText on secondary
--mutedMuted backgrounds
--muted-foregroundMuted/subtle text
--accentAccent highlights
--accent-foregroundText on accent
--destructiveError/danger states
--borderBorder colors
--inputInput field borders
--ringFocus ring color
--radiusBorder radius base value
--chart-1 to --chart-5Chart colors
--sidebar-*Sidebar-specific colors

Color Format

Colors use OKLCH format: oklch(lightness chroma hue)

  • Lightness: 0 (black) to 1 (white)
  • Chroma: 0 (gray) to ~0.4 (vivid)
  • Hue: 0-360 degrees (red=0, green=142, blue=264, etc.)

Instructions

When the user requests a theme change:

  1. Identify which color variables need to change
  2. Update values in both :root (light) and .dark sections
  3. Ensure sufficient contrast between foreground/background pairs
  4. Keep the OKLCH format for consistency

Tips

  • Use oklch.com to pick colors
  • Test both light and dark modes
  • Ensure accessibility (contrast ratios)