Skip to content

Conversation

@vnz
Copy link
Owner

@vnz vnz commented Dec 20, 2025

Summary

Initial setup for ai03 Altair (5-row, 64-key split ergonomic keyboard).

Altair Specs

Spec Value
Designer ai03 Design Studio
Keys 64 (5 rows × 7 cols per side + 4 thumb keys)
MCU RP2040
Layout Split ergonomic with inner symbol columns

Current State

  • Create vnz keymap with default layout
  • Port Better-Shift to Lower layer
  • Port French accents to Raise layer
  • Add Adjust layer (Lower+Raise)
  • Add vnz.h shared code
  • Test compile

Layout Reference

ESC   1     2     3     4     5     -     │ =     6     7     8     9     0     BSPC
CAPS  Q     W     E     R     T     [     │ ]     Y     U     I     O     P     \
LCTL  A     S     D     F     G     (     │ )     H     J     K     L     ;     '
LSFT  Z     X     C     V     B     `     │ PSCR  N     M     ,     .     /     ENT
                  GUI   ALT   L1    SPC   │ SPC   L1    TAB   DEL

🤖 Generated with Claude Code

Initial setup for ai03 Altair (5-row, 64-key split ergonomic):
- Create vnz keymap directory with default layout
- Add to qmk.json build targets

Layout will be customized in subsequent commits.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@vnz vnz self-assigned this Dec 20, 2025
@gemini-code-assist
Copy link

Summary of Changes

Hello @vnz, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces the foundational support for the ai03 Altair keyboard within the project. It establishes a new keymap, 'vnz', which provides a default layout for the keyboard's 64 keys across two layers. This initial integration allows for the compilation of firmware for the Altair with a predefined key configuration, setting the stage for future enhancements and custom features as outlined in the PR description.

Highlights

  • New Keyboard Support: Initial setup for the ai03 Altair keyboard has been added, including its basic configuration.
  • vnz Keymap: A new keymap named 'vnz' has been created for the Altair keyboard, defining its default layout for both base and function layers.
  • QMK Configuration Update: The qmk.json file has been updated to register the new 'vnz' keymap for the ai03 Altair keyboard, making it discoverable by the QMK build system.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new vnz keymap for the ai03/altair keyboard. The implementation includes a base layer and a function layer for navigation and F-keys. The changes look good, but I've found a critical typo in a keycode within keymap.c that will prevent compilation. I've left a specific comment with a suggestion to fix it. Once addressed, the keymap should be ready for further development as outlined in your checklist.

vnz and others added 2 commits December 20, 2025 17:26
Full 4-layer layout for ai03 Altair (64-key split ergonomic):

Base layer:
- QWERTY with bracket progression on inner columns: [ ] { } ( ) Home End
- Thumb: GUI ALT SPC LOWER | RAISE SPC ↓ ↑
- CTRL on pinky, ESC on home row

Lower layer (Better-Shift):
- Shifted alphanumerics without holding Shift
- PgUp/PgDn on inner columns
- Tab switching (TBLT/TBRT) on thumb

Raise layer (French accents):
- é è ê ë à â ù û ü î ï ô œ ç € positioned on QWERTY base letters
- All F-keys (F1-F12) on number row including inner columns
- Horizontal arrows (← →) on thumb

Adjust layer (Lower + Raise):
- Uppercase French accents (É È Ê Ë À Â Ù Û Ü Î Ï Ô Œ Ç)
- Unicode mode switches (UC_MAC, UC_WINC, UC_LINX)
- QK_BOOT, NK_TOGG, backslash

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Thumb row (8 keys) is centered under main rows (14 keys), so offset
should be 3 columns on each side, not 2.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant