[Bug]: Change appearance shortcut fails on macOS AZERTY (Option+Shift+Cmd+A)
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 67/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- typescript
- Domain
- desktop, developer-experience
Research direction
Start in apps/web/src/keybindings.ts and inspect resolveEventKeys, which the report identifies as falling back to KeyboardEvent.code when event.key is not a Latin letter. Add a unit test for the described synthetic Option+Shift+Cmd event with key "Æ" and code "KeyQ", then run the relevant keybinding tests. Done means the active-layout A key triggers the advertised appearance shortcut without breaking the existing physical-key fallback.
Written by the indexing model from the issue text.
Description
Before submitting
- I searched existing issues and did not find a duplicate.
- I included enough detail to reproduce or investigate the problem.
Area
apps/web
Steps to reproduce
- Use a MacBook Pro with a French AZERTY keyboard layout.
- Open T3 Code and keep focus outside the integrated terminal.
- Open the command palette and search for "Change appearance". It advertises Option+Shift+Cmd+A (⌥⇧⌘A).
- Close the palette and press that combination using the key labeled A on the AZERTY keyboard.
- Press it several times to distinguish a missed shortcut from a transition between System and the same effective light/dark mode.
Expected behavior
The advertised shortcut should cycle System → Light → Dark → System, using the A key from the active keyboard layout.
Actual behavior
The advertised shortcut does not appear to change the appearance on my MacBook Pro with an AZERTY keyboard.
Suspected cause (source inspection)
In apps/web/src/keybindings.ts, resolveEventKeys falls back to the letter in KeyboardEvent.code when event.key is not a Latin a–z character. Option can turn a letter into a symbol. On AZERTY, the key labeled A has code KeyQ, so this fallback can resolve it as q rather than a and miss the default mod+alt+shift+a binding.
For example, a synthetic event with key: "Æ", code: "KeyQ", metaKey: true, altKey: true and shiftKey: true exercises this mismatch. This is a unit-test input, not a captured keyboard-event log from my machine.
Related reports
- #2261: Option-modified letter shortcuts failing on macOS (closed).
- #4434 / #4469: Latin layout letters take precedence over physical positions, but the physical fallback remains for Option-generated symbols.
- #13229: the recorder displays US key positions for non-US punctuation (open); related layout handling, but a different symptom.
I did not find an existing report specifically covering Option-modified A on AZERTY for appearance.cycle.
Impact
Minor bug or occasional failure
Version or commit
Personal build based on upstream v0.0.45; shortcut matching inspected in the upstream source as well.
Environment
macOS, MacBook Pro, French AZERTY keyboard. macOS 26.7.1
Logs or stack traces
Screenshots, recordings, or supporting files
No response
Workaround
Use the command palette → Change appearance and select a mode manually, or assign a shortcut without Option in Settings → Keybindings.
- Dominant language
- TypeScript
- Stars
- 24.8k
- Forks
- 6.4k
- Avg merge
- 7h 14m
- Merged PRs (30d)
- 201
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from pingdotgg/t3code
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
bug via-triage
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
pingdotgg/t3code#16096 · 1 comment ·
Maintainers usually reply within 1 day
-
bug via-triage
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
pingdotgg/t3code#16090 · 2 comments ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Maintainers usually reply within 1 day
-
[Bug]: IntelliJ IDEA not detected on macOS when the Toolbox app bundle has a version in its namePossibly taken A pull request linked to this issue is open or already merged. Openbug via-triage
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
pingdotgg/t3code#15933 · 1 comment ·
Maintainers usually reply within 1 day
All issues in pingdotgg/t3code
Similar issues
-
area:docs bug triage:confirmed
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Cotal-AI/Cotal#2875 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
anomalyco/models.dev#8862 · 1 comment ·
Maintainers usually reply within 1 day
-
fix(data-lake): wizard source step still previews the local slug, not the server-disambiguated oneOpendata-lake
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
ready-for-triage
Difficulty 1/5 Under an hour Newbie friendliness 88/100
konflux-ci/konflux-ui#1596 · 1 comment ·
Maintainers usually reply within 1 day
-
enhancement good first issue priority: low size: XS
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day