From 88306f00919039257d7899029ddebd0a508f554a Mon Sep 17 00:00:00 2001 From: Codex CLI Date: Fri, 29 Aug 2025 01:21:07 -0500 Subject: [PATCH] docs: rewrite color scheme as plain-language hex definitions --- AGENTS.md | 39 ++++++++++++++++++++++++++++++++------- 1 file changed, 32 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b4595cf..027b4b1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,13 +21,38 @@ - XAML: keep styles in `Styles/*.axaml`; avoid inline styling; prefer bindings and converters in `Converters/*`. ## Color Scheme (Official) -- `--c-primary-1`: `#5AC3D6`; `--c-primary-2`: `#223544`; `--c-primary-3`: `#4E6D84`. -- `--c-emph-1`: `#F5A623`; `--c-emph-2`: `#D94E87`; `--c-emph-3`: `#49C46D`. -- `--bg`: `var(--c-primary-3)`; `--surface`: `var(--c-primary-2)`; `--text`: `#EAF2F7`. -- `--muted`: `rgba(255,255,255,0.75)`; `--border`: `rgba(255,255,255,0.18)`. -- `--input-bg`: `rgba(255,255,255,0.06)`; `--input-border`: `rgba(255,255,255,0.22)`. -- `--link`: `var(--c-primary-1)`; `--focus`: `var(--c-primary-1)`. -- Avalonia mapping: define colors/brushes in `Styles/Colors.axaml` (e.g., `CPrimary1/2/3`, `CEmph1/2/3`; `ThemeAccentBrush` from primary‑1; background/surfaces from `--bg/--surface`; text from `--text`). Keep all UI colors derived from these tokens. +### Primary Colors +- Primary 1: `#5AC3D6` — Accent/brand; used for links, primary buttons, and focus highlights. +- Primary 2: `#223544` — Deep surface; used for app chrome, panels, and elevated containers. +- Primary 3: `#4E6D84` — Background shell; used for main window backgrounds and large surfaces. + +### Emphasis Colors +- Emphasis 1: `#F5A623` — Warning/attention highlights and subtle callouts. +- Emphasis 2: `#D94E87` — Destructive/negative emphasis (e.g., remove/close actions). +- Emphasis 3: `#49C46D` — Success/positive emphasis (e.g., confirmations, success badges). + +### Background & Surfaces +- Background: `#4E6D84` — Same as Primary 3; default app background. +- Surface: `#223544` — Same as Primary 2; cards, drawers, panels. + +### Text & Links +- Text: `#EAF2F7` — Primary text on dark surfaces. +- Link: `#5AC3D6` — Matches Primary 1. +- Focus Ring: `#5AC3D6` — Matches Primary 1 for accessibility. + +### Inputs & Borders +- Muted Text: `#FFFFFFBF` — 75% white over surfaces (semi‑transparent tint). +- Border: `#FFFFFF2E` — 18% white; subtle separators and dividers. +- Input Background: `#FFFFFF0F` — 6% white; faint fill for inputs. +- Input Border: `#FFFFFF38` — 22% white; input outlines on dark surfaces. + +Note: 8‑digit hex values follow `#RRGGBBAA` (alpha last) and correspond to the previous RGBA tints. + +### Avalonia Mapping +- Define brushes in `Styles/Colors.axaml`: `CPrimary1`, `CPrimary2`, `CPrimary3`, `CEmph1`, `CEmph2`, `CEmph3`. +- `ThemeAccentBrush`: derive from Primary 1. +- Background/Surface brushes: use Background and Surface above. +- Keep all UI colors derived from these tokens for consistency across Desktop, Browser, and Android. ## Testing Guidelines - No test projects yet. If adding tests, create `tests/AdvancedCalculator.Tests` (xUnit or NUnit), name files `*.Tests.cs`, and target `net8.0`.