docs: rewrite color scheme as plain-language hex definitions
This commit is contained in:
parent
72e0e47cd3
commit
88306f0091
1 changed files with 32 additions and 7 deletions
39
AGENTS.md
39
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`.
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue