add more q ultra 8k

keychron-dev · keychron-dev · commit dbc2b6bede94 · 2026-04-12T11:44:25.000+08:00
diff --git a/.github/badges/model-count.json b/.github/badges/model-count.json
@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "label": "models uploaded",
-  "message": "92",
+  "message": "96",
   "color": "brightgreen",
   "namedLogo": "github"
 }
diff --git a/Q-Ultra-8K-Series/Q1 Ultra 8k/README.md b/Q-Ultra-8K-Series/Q1 Ultra 8k/README.md
@@ -0,0 +1,45 @@
+# Keychron Q1 Ultra 8K — Hardware Design Files
+
+> 75% full-metal wireless custom mechanical keyboard with 8K polling, 256 kHz single-key scanning, Silk POM switches, and advanced acoustic foam.
+
+**Product page:** [Keychron Q1 Ultra 8K](https://www.keychron.com/products/keychron-q1-ultra-8k-wireless-custom-mechanical-keyboard)
+
+![Q1 Ultra 8K](https://www.keychron.com/cdn/shop/files/Q1-Ultra-8K-Features.jpg?crop=center&height=1200&v=1767603594&width=1200)
+
+## Current Repository Status
+
+- This folder is ready for future hardware design uploads for the Q1 Ultra 8K.
+- No local `stp`, `dwg`, `dxf`, `pdf`, or related CAD assets are included yet.
+
+## Expected File Types
+
+| File Type | Typical Use |
+|---|---|
+| `stp` | Case, plate, or full assembly 3D CAD |
+| `dwg` / `dxf` | Plate drawings and 2D manufacturing references |
+| `pdf` | Reference drawings and quick-view documents |
+
+## Product Snapshot
+
+| Spec | Detail |
+|---|---|
+| Layout | 75% |
+| Case Material | Full metal |
+| Connectivity | 2.4 GHz / Bluetooth |
+| Polling Rate | 8,000 Hz |
+| Single-Key Scan Rate | 256 kHz |
+| Firmware | ZMK open-source firmware |
+
+## Links
+
+- [Series Overview](../README.md)
+- [Q Ultra 8K Collection](https://www.keychron.com/collections/q-ultra-8k-series)
+- [Main Repository](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
+
+## License
+
+This project is **source-available**. Personal and educational use is allowed, and commercial use is allowed for original compatible accessories within the limits of the license.
+
+**You may not use these files to copy, manufacture, sell, or distribute Keychron keyboards or mice, or substantially similar products, and you may not use Keychron trademarks as your own branding.**
+
+See the [LICENSE](../../LICENSE) for full terms.
diff --git a/Q-Ultra-8K-Series/Q13 Ultra 8k/README.md b/Q-Ultra-8K-Series/Q13 Ultra 8k/README.md
@@ -0,0 +1,45 @@
+# Keychron Q13 Ultra 8K — Hardware Design Files
+
+> 96% Alice full-metal wireless custom mechanical keyboard with 8K polling, 256 kHz single-key scanning, Silk POM switches, and advanced acoustic foam.
+
+**Product page:** [Keychron Q13 Ultra 8K](https://www.keychron.com/products/keychron-q13-ultra-8k-wireless-custom-mechanical-keyboard)
+
+![Q13 Ultra 8K](https://www.keychron.com/cdn/shop/files/Keychron-Q13-Ultra-8K-Features.jpg?crop=center&height=1200&v=1772688212&width=1200)
+
+## Current Repository Status
+
+- This folder is ready for future hardware design uploads for the Q13 Ultra 8K.
+- No local `stp`, `dwg`, `dxf`, `pdf`, or related CAD assets are included yet.
+
+## Expected File Types
+
+| File Type | Typical Use |
+|---|---|
+| `stp` | Case, plate, or full assembly 3D CAD |
+| `dwg` / `dxf` | Plate drawings and 2D manufacturing references |
+| `pdf` | Reference drawings and quick-view documents |
+
+## Product Snapshot
+
+| Spec | Detail |
+|---|---|
+| Layout | 96% Alice |
+| Case Material | Full metal |
+| Connectivity | 2.4 GHz / Bluetooth |
+| Polling Rate | 8,000 Hz |
+| Single-Key Scan Rate | 256 kHz |
+| Firmware | ZMK open-source firmware |
+
+## Links
+
+- [Series Overview](../README.md)
+- [Q Ultra 8K Collection](https://www.keychron.com/collections/q-ultra-8k-series)
+- [Main Repository](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
+
+## License
+
+This project is **source-available**. Personal and educational use is allowed, and commercial use is allowed for original compatible accessories within the limits of the license.
+
+**You may not use these files to copy, manufacture, sell, or distribute Keychron keyboards or mice, or substantially similar products, and you may not use Keychron trademarks as your own branding.**
+
+See the [LICENSE](../../LICENSE) for full terms.
diff --git a/Q-Ultra-8K-Series/Q3 Ultra 8k/README.md b/Q-Ultra-8K-Series/Q3 Ultra 8k/README.md
@@ -0,0 +1,45 @@
+# Keychron Q3 Ultra 8K — Hardware Design Files
+
+> 80% TKL full-metal wireless mechanical keyboard with 2.4 GHz connectivity, 8K polling, and Keychron Launcher customization.
+
+**Product page:** [Keychron Q3 Ultra 8K](https://www.keychron.com/products/keychron-q3-ultra-8k-wireless-custom-mechanical-keyboard)
+
+![Q3 Ultra 8K](https://www.keychron.com/cdn/shop/files/Q3-Ultra-Iconic-Features-1.jpg?crop=center&height=1200&v=1767005341&width=1200)
+
+## Current Repository Status
+
+- This folder is ready for future hardware design uploads for the Q3 Ultra 8K.
+- No local `stp`, `dwg`, `dxf`, `pdf`, or related CAD assets are included yet.
+
+## Expected File Types
+
+| File Type | Typical Use |
+|---|---|
+| `stp` | Case, plate, or full assembly 3D CAD |
+| `dwg` / `dxf` | Plate drawings and 2D manufacturing references |
+| `pdf` | Reference drawings and quick-view documents |
+
+## Product Snapshot
+
+| Spec | Detail |
+|---|---|
+| Layout | 80% TKL |
+| Case Material | Full metal |
+| Connectivity | 2.4 GHz / Bluetooth |
+| Polling Rate | 8,000 Hz |
+| Device Pairing | Up to 3 Bluetooth devices |
+| Firmware | Keychron Launcher |
+
+## Links
+
+- [Series Overview](../README.md)
+- [Q Ultra 8K Collection](https://www.keychron.com/collections/q-ultra-8k-series)
+- [Main Repository](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
+
+## License
+
+This project is **source-available**. Personal and educational use is allowed, and commercial use is allowed for original compatible accessories within the limits of the license.
+
+**You may not use these files to copy, manufacture, sell, or distribute Keychron keyboards or mice, or substantially similar products, and you may not use Keychron trademarks as your own branding.**
+
+See the [LICENSE](../../LICENSE) for full terms.
diff --git a/Q-Ultra-8K-Series/Q5 Ultra 8k/README.md b/Q-Ultra-8K-Series/Q5 Ultra 8k/README.md
@@ -0,0 +1,46 @@
+# Keychron Q5 Ultra 8K — Hardware Design Files
+
+> 96% full-metal wireless custom mechanical keyboard with 8K polling, 256 kHz single-key scanning, a 660-hour battery, Silk POM switches, and advanced acoustic foam.
+
+**Product page:** [Keychron Q5 Ultra 8K](https://www.keychron.com/products/keychron-q5-ultra-8k-wireless-custom-mechanical-keyboard)
+
+![Q5 Ultra 8K](https://www.keychron.com/cdn/shop/files/Q5_Ultra-_features.jpg?crop=center&height=1200&v=1772618604&width=1200)
+
+## Current Repository Status
+
+- This folder is ready for future hardware design uploads for the Q5 Ultra 8K.
+- No local `stp`, `dwg`, `dxf`, `pdf`, or related CAD assets are included yet.
+
+## Expected File Types
+
+| File Type | Typical Use |
+|---|---|
+| `stp` | Case, plate, or full assembly 3D CAD |
+| `dwg` / `dxf` | Plate drawings and 2D manufacturing references |
+| `pdf` | Reference drawings and quick-view documents |
+
+## Product Snapshot
+
+| Spec | Detail |
+|---|---|
+| Layout | 96% |
+| Case Material | Full metal |
+| Connectivity | 2.4 GHz / Bluetooth |
+| Polling Rate | 8,000 Hz |
+| Single-Key Scan Rate | 256 kHz |
+| Battery Life | Up to 660 hours |
+| Firmware | ZMK open-source firmware |
+
+## Links
+
+- [Series Overview](../README.md)
+- [Q Ultra 8K Collection](https://www.keychron.com/collections/q-ultra-8k-series)
+- [Main Repository](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
+
+## License
+
+This project is **source-available**. Personal and educational use is allowed, and commercial use is allowed for original compatible accessories within the limits of the license.
+
+**You may not use these files to copy, manufacture, sell, or distribute Keychron keyboards or mice, or substantially similar products, and you may not use Keychron trademarks as your own branding.**
+
+See the [LICENSE](../../LICENSE) for full terms.
diff --git a/Q-Ultra-8K-Series/Q6 Ultra 8k/README.md b/Q-Ultra-8K-Series/Q6 Ultra 8k/README.md
@@ -4,7 +4,7 @@
 
 **Product page:** [Keychron Q6 Ultra 8K](https://www.keychron.com/products/keychron-q6-ultra-8k-wireless-custom-mechanical-keyboard)
 
-![Q6 Ultra 8K](https://www.keychron.com/cdn/shop/files/Keychron_Q6_Ultra_8K_Wireless_Custom_Mechanical_Keyboard-2_cf3810f0-86ac-4544-aad2-6dfe1a0353c5.jpg?v=1764227295)
+![Q6 Ultra 8K](https://www.keychron.com/cdn/shop/files/Keychron-Q6-Ultra-8K-Features.jpg?crop=center&height=1200&v=1767600682&width=1200)
 
 ## Included Files
 
diff --git a/Q-Ultra-8K-Series/README.md b/Q-Ultra-8K-Series/README.md
@@ -1,41 +1,56 @@
 # Q Ultra 8K Series — Hardware Design Files
 
-> Premium Q series keyboards with 8K polling support, aluminum construction, and open hardware plate files for customization and accessory development.
+> Premium wireless aluminum Q-series keyboards with 8K polling, ZMK open-source firmware, and room for future CAD releases across multiple layouts.
 
 Part of the [Keychron Keyboards Hardware Design](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design) repository.
 
 ## Available Models
 
 | Model | Layout | Size | Knob | Firmware |
 |---|---|---|---|---|
-| [Q6 Ultra 8K](./Q6%20Ultra%208k/README.md) | Full-size | 104-key | Yes | — |
+| [Q1 Ultra 8K](./Q1%20Ultra%208k/README.md) | 75% | Compact | Yes | ZMK |
+| [Q3 Ultra 8K](./Q3%20Ultra%208k/README.md) | TKL | 80% | Yes | ZMK |
+| [Q5 Ultra 8K](./Q5%20Ultra%208k/README.md) | 96% | Compact | Yes | ZMK |
+| [Q6 Ultra 8K](./Q6%20Ultra%208k/README.md) | Full-size | 100% | Yes | ZMK |
+| [Q13 Ultra 8K](./Q13%20Ultra%208k/README.md) | 96% Alice | Alice | Yes | ZMK |
 
 ## Repository Contents
 
-This series folder currently includes hardware files for the following model:
+This series folder currently includes model folders for:
 
+- [Q1 Ultra 8K](./Q1%20Ultra%208k/README.md)
+- [Q3 Ultra 8K](./Q3%20Ultra%208k/README.md)
+- [Q5 Ultra 8K](./Q5%20Ultra%208k/README.md)
 - [Q6 Ultra 8K](./Q6%20Ultra%208k/README.md)
+- [Q13 Ultra 8K](./Q13%20Ultra%208k/README.md)
 
-If additional Q Ultra 8K models are published to this repository later, they can be added here using the same structure as the other series folders.
+At the moment, only the Q6 Ultra 8K folder includes published plate files in this repository. The other model folders are ready for future `stp`, `dwg`, `dxf`, `pdf`, or related hardware uploads.
 
 ## Download Files
 
 | File | Description | Format |
 |---|---|---|
-| **Plate** | Switch mounting plate with cutout dimensions | DWG / PDF |
+| **Plate** | Published switch mounting plate drawings | DWG / PDF |
+| **Future CAD assets** | Placeholder folders ready for case, plate, or full-model releases | STP / DWG / DXF / PDF |
 
 ## Opening the Files
 
 | Format | Free Software | Commercial Software |
 |---|---|---|
+| `.stp` | FreeCAD, Onshape | Fusion 360, SolidWorks |
 | `.dwg` | LibreCAD (limited), QCAD | AutoCAD, DraftSight |
+| `.dxf` | LibreCAD, QCAD | AutoCAD, DraftSight |
 | `.pdf` | Any PDF viewer | — |
 
 ## Directory Structure
 
 ```text
 Q-Ultra-8K-Series/
+├── Q1 Ultra 8k/
+├── Q3 Ultra 8k/
+├── Q5 Ultra 8k/
 ├── Q6 Ultra 8k/
+├── Q13 Ultra 8k/
 └── README.md
 ```
 
@@ -49,5 +64,6 @@ See the [LICENSE](../LICENSE) file for full terms.
 
 ## Links
 
+- [Q Ultra 8K Collection](https://www.keychron.com/collections/q-ultra-8k-series)
 - [Open Source Design Center](https://www.keychron.com/collections/keychron-open-source)
 - [Main Repository](https://github.com/Keychron/Keychron-Keyboards-Hardware-Design)
diff --git a/README.md b/README.md
@@ -15,6 +15,7 @@ Study real CAD. Remix plates and cases. Design compatible accessories. Learn fro
 
 ## Latest Updates
 
+- **2026-04-12:** Added Q1 Ultra 8K, Q3 Ultra 8K, Q5 Ultra 8K, and Q13 Ultra 8K series folders and README pages.
 - **2026-04-11:** Added C3 Pro 8K, K4 HE, K8 HE, K2 QMK, Q0 HE, and Q12 HE.
 - **2026-04-10:** Added more K0 Max files, Q12 HE and more Q6 Max files and more keycap profiles.
 - **2026-04-09:** Added K10 HE, Q6 Max and K0 Max design files. Update: make the accessories not subject to licensing.
@@ -67,7 +68,7 @@ If you're new, begin with one of these paths:
 | **Q Pro Series** | Keyboard | Q1 Pro–Q14 Pro (10 models) | Case, Plate, Encoder, Full Model, Stabilizer, KSA Keycap |
 | **Q HE Series** | Hall Effect | Q0 HE, Q1 HE, Q3 HE, Q5 HE, Q6 HE, Q12 HE | Plate, Full Model, selected case parts |
 | **Q Max Series** | Keyboard | Q6 Max | Case, Plate, Full Model, Stabilizer |
-| **Q Ultra 8K Series** | Keyboard | Q6 Ultra 8K | Plate |
+| **Q Ultra 8K Series** | Keyboard | Q1 Ultra 8K, Q3 Ultra 8K, Q5 Ultra 8K, Q6 Ultra 8K, Q13 Ultra 8K | Published plate files for Q6 Ultra 8K; README/model pages prepared for the others |
 | **K Pro Series** | Keyboard | K1 Pro–K17 Pro (16 models) | Case, Plate, Full Model, Stabilizer |
 | **K Max Series** | Keyboard | K0 Max, K1 Max–K17 Max (12 models) | Case, Plate, Full Model, Stabilizer, Keycap on selected models |
 | **K HE Series** | Hall Effect | K2 HE, K4 HE, K6 HE, K8 HE, K10 HE | Published models include case, plate, full model, stabilizer, and selected keycap files; K6 HE is currently folder-only |
@@ -77,7 +78,7 @@ If you're new, begin with one of these paths:
 | **P HE Series** | Hall Effect | P1 HE | Case, Plate, Full Model, Stabilizer, Keycap |
 | **Mouse Series** | Mouse | M1–M7, G1, G2 (11 models) | Shell, Full Model |
 
-**92 device models. 734+ design files. Source-available. Accessory-friendly.**
+**96 device models. 734+ design files. Source-available. Accessory-friendly.**
 ![Keychron keyboards structure design](docs/assets/keychron-keyboards-structures.webp)
 
 ## Directory Structure
@@ -94,7 +95,7 @@ Q-Pro-Series/
 Q-Max-Series/
   Q6 Max/               — Wireless Q-series case, plate, full model, and stabilizer files
 Q-Ultra-8K-Series/
-  Q6 Ultra 8K/          — Ultra 8K plate files
+  Q1 Ultra 8K/          — README and product page reference, ready for future CAD uploads alongside Q3, Q5, Q6, and Q13 Ultra 8K
 K-Pro-Series/
   K1 Pro/               — Low-profile and standard K Pro models through K17 Pro
   K8 Pro/               — Example model folder with `K8-Pro-Keycap.stp`
diff --git a/docs/repo-inventory.md b/docs/repo-inventory.md
@@ -2,7 +2,7 @@
 
 Generated from the current filesystem using `scripts/repo_inventory.py`.
 
-- Total model directories: **98**
+- Total model directories: **102**
 - Total data files across model directories: **734**
 
 ## Series Summary
@@ -13,7 +13,7 @@ Generated from the current filesystem using `scripts/repo_inventory.py`.
 | Q-Pro-Series | 10 | 86 |
 | Q-HE-Series | 6 | 35 |
 | Q-Max-Series | 1 | 10 |
-| Q-Ultra-8K-Series | 1 | 4 |
+| Q-Ultra-8K-Series | 5 | 4 |
 | K-Pro-Series | 16 | 129 |
 | K-Max-Series | 12 | 130 |
 | K-HE-Series | 5 | 41 |
@@ -251,6 +251,34 @@ Generated from the current filesystem using `scripts/repo_inventory.py`.
 - README present: yes
 - Extensions: `.dwg` x2, `.md` x1, `.pdf` x2, `.stp` x5, `.zip` x1
 
+### Q-Ultra-8K-Series / Q1 Ultra 8k
+
+- Path: `Q-Ultra-8K-Series/Q1 Ultra 8k`
+- Data files: 0
+- README present: yes
+- Extensions: `.md` x1
+
+### Q-Ultra-8K-Series / Q13 Ultra 8k
+
+- Path: `Q-Ultra-8K-Series/Q13 Ultra 8k`
+- Data files: 0
+- README present: yes
+- Extensions: `.md` x1
+
+### Q-Ultra-8K-Series / Q3 Ultra 8k
+
+- Path: `Q-Ultra-8K-Series/Q3 Ultra 8k`
+- Data files: 0
+- README present: yes
+- Extensions: `.md` x1
+
+### Q-Ultra-8K-Series / Q5 Ultra 8k
+
+- Path: `Q-Ultra-8K-Series/Q5 Ultra 8k`
+- Data files: 0
+- README present: yes
+- Extensions: `.md` x1
+
 ### Q-Ultra-8K-Series / Q6 Ultra 8k
 
 - Path: `Q-Ultra-8K-Series/Q6 Ultra 8k`

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"schemaVersion": 1,`
`3`	`3`	`"label": "models uploaded",`
`4`		`- "message": "92",`
	`4`	`+ "message": "96",`
`5`	`5`	`"color": "brightgreen",`
`6`	`6`	`"namedLogo": "github"`
`7`	`7`	`}`