diff --git a/AGENTS.md b/AGENTS.md
index 2999981..2449a8f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -56,6 +56,7 @@ Personal engineering portfolio — multi-page SPA built with React + TypeScript
- `type Palette = 'red' | 'blue'` (`src/types/index.ts`), labels/hints in `src/data/palettes.ts` (`paletteIds`, `paletteMeta`); default `red`
- `data-palette` attribute + `localStorage` key `portfolio-palette`; `index.html`'s init script writes both attributes before paint
- Palette overrides in `src/index.css` are `:root[data-theme='dark'][data-palette='blue']` / `:root[data-theme='light'][data-palette='blue']` (specificity 0,3,0 — they beat the base blocks regardless of order); no blue variant exists in the `prefers-color-scheme` bridge, because the init script always writes `data-palette`
+- Accent has two tiers: `--accent` / `--accent-hover` / `--accent-active` are the bright signal colours (links, underlines, borders, glows) and the fill of the pale accent surfaces (palette-option hover, `.tag-accent`, `.back-to-top`, resume summary bar); `--accent-solid` / `-hover` / `-active` plus `--text-on-accent-solid` are the deeper fill and light text used by `.btn-primary` and `.badge-accent`, which is what lets a dark-mode button carry light text. The solid family is declared in all five blocks of `src/index.css` (dark red, light red, dark blue, light blue, the `prefers-color-scheme` bridge); the two light blocks duplicate the plain accent values verbatim, so light mode does not move. Spec: `docs/design/specs/v3/spec-v3-nav-cta-enhancements.md`
- Picker, two renderings, both present at every width: the bar uses `src/components/layout/ThemePaletteMenu.tsx` — icon-only trigger (`nav-control nav-palette-trigger`, a 20px half-circle swatch: active palette's accent on the left, `--swatch-empty` on the right; no text, no chevron; the name lives in `aria-label`, the hint in `title`) opening the `#palette-menu` panel. The sheet renders its own Theme color row inside `MobileMenu.tsx` from `paletteIds` + `paletteMeta` as `.mobile-menu-swatch-option` buttons — the same segmented shape as the Mode/Language rows, options drawn as colour icons via `.nav-palette-preview`. `ThemePaletteMenu` has no `variant` prop and is never mounted in the sheet
- Bar controls share one chrome: `.nav-control` covers the mode toggle, the language toggle and the palette trigger (44px bordered box, accent border + text on hover/open, one `:focus-visible`). All four controls — mode, language, theme color, hamburger — sit in `.nav-actions` at every width, in that order; `@media (max-width: 420px)` tightens the container padding and action gap so the row fits a 320px viewport
@@ -93,6 +94,7 @@ src/
- `RollingTextLink.tsx` — animated text-scrolling navigation link
- `BackToTop.tsx` — scroll-to-top floating button with AnimatePresence
- `HeroParticles.tsx` — decorative particle background (uses AnimatePresence)
+- Palette swatch rotation — `ThemePaletteMenu.tsx` renders the swatch as a `motion.span` whose `rotate` target is 90° while the `#palette-menu` submenu is open and 0° otherwise; reduced motion comes from the global `motion.config.reducedMotion = 'user'` in `main.tsx`, so no per-component branch
## External Assets
@@ -155,7 +157,7 @@ All specification documents are in `docs/design/`:
| `spec-v2.md` | v2 index — overview, implementation order, feature list |
| `specs/ui/spec-ui-*.md` | UI specs per section (hero, about, expertise, etc.) |
| `specs/v2/spec-v2-*.md` | v2 feature specs (resume, seo, blog, analytics, testing, cicd) |
-| `specs/v3/spec-v3-*.md` | v3 feature specs (theme colors, theme switch, theme palette switch, UI enhancements) |
+| `specs/v3/spec-v3-*.md` | v3 feature specs (theme colors, theme switch, theme palette switch, UI enhancements, mobile navigation, nav & CTA enhancements) |
Read `spec.md` first for product context. Read `spec-v2.md` for current feature scope.
diff --git a/docs/design/specs/v3/spec-v3-nav-cta-enhancements.md b/docs/design/specs/v3/spec-v3-nav-cta-enhancements.md
new file mode 100644
index 0000000..fd32e1c
--- /dev/null
+++ b/docs/design/specs/v3/spec-v3-nav-cta-enhancements.md
@@ -0,0 +1,318 @@
+# Specification — v3 Nav Bar & CTA Enhancements
+
+> **Document:** `spec-v3-nav-cta-enhancements.md`
+> **Version:** 0.2.0 (drafted 2026-10-17 after the owner answered Q1–Q8; built the same day)
+> **Parents:** `specs/ui/spec-ui-layout.md` (bar controls), `spec-v3-theme-palette-switch.md` (palette blocks, `--accent` family), `spec-v3-typography.md` (chrome band), `spec-v3-mobile-navigation.md` (§13 findings this spec closes one of)
+> **Priority:** P2
+> **Estimate:** ~40 minutes including the gate re-run
+> **Status:** BUILT 2026-10-17 — Steps 1–5 on disk, §9.1 records the gate run and the SSR smoke. Open: the owner's browser pass (A1, A3, A4, A5, A6, A7, A9) and the commit decision.
+
+---
+
+## 1. Request
+
+1. **Replace the language control's `EN`/`VI` text with an icon** — the owner asked which icon suits the two languages.
+2. **Add motion to the theme-colour control**: clicking rotates the circle 90°; it rotates back after a colour is selected or the control loses focus.
+3. **The text inside the buttons looks too dark in dark mode** — make it lighter, similar to light mode.
+
+Request 3 is not a navigation-bar item. The buttons in question are `.btn-primary` in the hero CTA cluster (`src/components/sections/Hero.tsx:93-98`, `:24`), styled at `src/App.css:455-471`. The spec covers both surfaces because they were requested as one change set.
+
+---
+
+## 2. Current state (verified against the code, 2026-10-17)
+
+### 2.1 Facts
+
+| Fact | Evidence |
+|---|---|
+| The language control is a text glyph: `{lang === 'en' ? 'VI' : 'EN'}` inside `nav-control lang-toggle` | `src/components/layout/Navigation.tsx:102-109` |
+| `.lang-toggle` sets `font-size: 13px; font-weight: 600; letter-spacing: 0.5px` | `src/App.css:119-123` |
+| The bar's other two controls are icon-only (inline sun/moon SVG; the half-circle swatch), so the language control is the only text control in the bar | `Navigation.tsx:84-100`, `:111`, `src/App.css:331-340` |
+| `public/icons.svg` holds social symbols only (`github-icon`, `x-icon`, …); every bar icon is inline SVG | `grep id= public/icons.svg` |
+| The palette trigger is `` — a plain span, no motion, **no `transition` declared** | `ThemePaletteMenu.tsx:39`, `src/App.css:333-340` |
+| The swatch is `linear-gradient(to right, var(--accent) 0 50%, var(--swatch-empty) 50% 100%)`, 20×20, `border-radius: 50%` | `src/App.css:333-340` |
+| The trigger carries `.open` while the submenu is open; `.open` clears on selection, on Escape, and on pointer-down outside | `ThemePaletteMenu.tsx:32`, `:49-51`, `:18-25`, `src/hooks/useClickOutside.ts:10-11` |
+| `useClickOutside` listens to `mousedown`/`touchstart` only — **blur does not close the submenu** | `src/hooks/useClickOutside.ts:10-11` |
+| `motion.config.reducedMotion = 'user'` is set once at boot | `src/main.tsx:7-9` |
+| `.btn-primary` = `background: var(--accent)` + `color: var(--text-on-accent)` + `border: 1px solid transparent` + `box-shadow: var(--accent-glow)`; hover uses `--accent-hover` | `src/App.css:455-471` |
+| `.badge-accent` uses the same `--accent` / `--text-on-accent` pair, 12px text | `src/App.css:534-537` |
+| `.btn-primary` has exactly three live call sites, all in the hero: two `
diff --git a/src/index.css b/src/index.css
index 42b96d5..783c801 100644
--- a/src/index.css
+++ b/src/index.css
@@ -10,6 +10,14 @@
--accent-hover: #fca5a5;
--accent-active: #f06060;
--text-on-accent: #151914;
+ /* Solid accent family: the fill of a surface that carries text (buttons, badges). The bright
+ --accent above stays the signal colour — links, underlines, borders, glows — and the fill of
+ the accent surfaces this set does not cover. Measured ratios in
+ docs/design/specs/v3/spec-v3-nav-cta-enhancements.md §4.4. */
+ --accent-solid: #b04138;
+ --accent-solid-hover: #a33a32;
+ --accent-solid-active: #9b3229;
+ --text-on-accent-solid: #f6f5f2;
--accent-soft: rgba(248, 113, 113, 0.12);
--accent-tint: #2f1e1a;
--accent-glow: rgba(248, 113, 113, 0.3);
@@ -68,6 +76,12 @@
--accent-hover: #a8382f;
--accent-active: #9b3229;
--text-on-accent: #ffffff;
+ /* Solid accent family — the fill that carries text. These four duplicate --accent,
+ --accent-hover, --accent-active and --text-on-accent verbatim: light mode does not move. */
+ --accent-solid: #b04138;
+ --accent-solid-hover: #a8382f;
+ --accent-solid-active: #9b3229;
+ --text-on-accent-solid: #ffffff;
--accent-soft: rgba(176, 65, 56, 0.1);
--accent-tint: #f5e3e1;
--accent-glow: rgba(176, 65, 56, 0.22);
@@ -97,6 +111,12 @@
--accent-hover: #93c5fd;
--accent-active: #3b82f6;
--text-on-accent: #0f1117;
+ /* Solid accent family — the fill that carries text. Blue starts one step deeper than the
+ light-mode blue accent: #e8eaed on #2563eb measures 4.29, under the 4.5 text floor. */
+ --accent-solid: #1d4ed8;
+ --accent-solid-hover: #1e40af;
+ --accent-solid-active: #1c3f9e;
+ --text-on-accent-solid: #e8eaed;
--accent-soft: rgba(96, 165, 250, 0.12);
--accent-tint: #182338;
--accent-glow: rgba(96, 165, 250, 0.3);
@@ -124,6 +144,11 @@
--accent-hover: #1d4ed8;
--accent-active: #1e40af;
--text-on-accent: #ffffff;
+ /* Solid accent family — the fill that carries text (spec-v3-nav-cta-enhancements.md §4.3) */
+ --accent-solid: #2563eb;
+ --accent-solid-hover: #1d4ed8;
+ --accent-solid-active: #1e40af;
+ --text-on-accent-solid: #ffffff;
--accent-soft: rgba(37, 99, 235, 0.1);
--accent-tint: #eef3fc;
--accent-glow: rgba(37, 99, 235, 0.22);
@@ -164,6 +189,11 @@
--accent-hover: #a8382f;
--accent-active: #9b3229;
--text-on-accent: #ffffff;
+ /* Solid accent family — the fill that carries text (spec-v3-nav-cta-enhancements.md §4.3) */
+ --accent-solid: #b04138;
+ --accent-solid-hover: #a8382f;
+ --accent-solid-active: #9b3229;
+ --text-on-accent-solid: #ffffff;
--accent-soft: rgba(176, 65, 56, 0.1);
--accent-tint: #f5e3e1;
--accent-glow: rgba(176, 65, 56, 0.22);