Skip to content

slopus/codex-keybored

Repository files navigation

Exploded CODEX KEYBORED product render showing the CNC enclosure, six-layer PCB, switches, and controls

CODEX KEYBORED

WORK LOAFER EDITION · MECHANICS REV B · ELECTRONICS REV A2

A from-scratch, manufacturable parody of the Codex Micro: Fusion 360 mechanics,
four quoted CNC parts, a wired six-layer PCB, turnkey assembly instructions, and working USB HID firmware.

VIEW THE MANUFACTURING DOSSIER  ·  DOWNLOAD COMPLETE HANDOFF  ·  OPEN FUSION ARCHIVE

Fusion 360 KiCad 10 DRC clean JLC quote


THIS IS NOT A DISCLAIMER.
THIS IS THE WHOLE POINT.

ABSOLUTELY EVERYTHING HERE IS 100% VIBE-CODED.

FROM THE FIRST PROMPT TO FUSION 360, KICAD, GERBERS, FIRMWARE,
AND A REAL UPLOAD INTO JLCPCB + JLCCNC.

THIS IS THE PRODUCT STORY: ONE CONTINUOUS VIBE
FROM A PUBLIC PRODUCT IMAGE
TO A REAL, QUOTED, FACTORY-READY HARDWARE STACK.

THE DELIGHTFUL PART IS THAT THE VIBE DID NOT STOP WHEN THE WORK BECAME PHYSICAL.
It crossed industrial design, parametric CAD, CNC drawings, multilayer electronics, component sourcing, USB firmware, factory testing, pricing, and vendor handoff. Every layer is editable, inspectable, and ready to continue.

One vibe, all the way to the factory

Most vibe-coded projects end at a screenshot. This one kept going until the pixels became toleranced solids, the solids became quoted CNC parts, the control layout became a routed six-layer PCB, the PCB became Gerbers/BOM/CPL, the firmware became checksummed factory binaries, and the whole stack became live JLC manufacturing jobs.

That is the fun of this repository: the same conversational build loop moves through every engineering discipline without hiding the seams. “The aluminum base is slightly tilted” became a 5° Fusion body. “Not a foot, a ring” became a purchased JIS G‑65 O-ring, a concentric retention groove, refreshed STEP/DXF/PDF exports, a successful JLCCNC import, a $68.31 live base quote, and a cleaned cart. “I do not want to solder switches” became a both-side PCBA configuration, consigned-parts manifest, 74-position placement file, manual assembly contract, flashing procedure, and functional acceptance test.

Vibe-coding pass What was created Where it became real
Look closely Public renders were compared, scaled, and converted into an explicit confirmed/measured/inferred datum set Research notes + manufacturing dossier
Make it solid A parametric 108 × 108 mm assembly, corrected wedge, captured light pipe, joystick cap, and purchased continuous grip ring Fusion 360 scripts + four STEP/DXF packages + G‑65 vendor reference
Make it electronic A clean-room STM32F072 architecture, matrix, USB-C, touch, joystick, 24 RGB pixels, six copper layers KiCad source + 0-error DRC + IPC netlist
Make it behave USB HID firmware, neutral F13–F24 map, RGB safety limit, factory browser test BIN/HEX/ELF + SHA-256 checksums
Make it buildable LCSC mappings, BOM/CPL, specialty-parts sourcing, manual operations, inspection gates Turnkey factory ZIP + controlled SOP
Make the factory answer CAD and fabrication files were uploaded into authenticated quote flows Four current JLCCNC items + JLCMC G‑65 ring + JLCPCB job Y5
PROMPT → RESEARCH → DIMENSIONS → FUSION 360 → STEP/DXF → JLCCNC
                     ↓
              ELECTRICAL PLAN → KICAD → GERBER/BOM/CPL → JLCPCB
                     ↓
              FIRMWARE → FACTORY TEST → TURNKEY HANDOFF → A FEW FINAL SCREWS

The result is not “AI made a picture of a keyboard.” The result is a versioned hardware project in which a vibe-driven decision can be traced from sentence to parameter, from parameter to geometry or net, and from production file to a factory price. That end-to-end continuity is the project.


The whole device, not just a render

Mechanical Electronics Factory route
108 × 108 mm outer envelope 90 × 90 mm, six copper layers 4 CNC parts already quoted
machined aluminum wedge STM32F072 + USB-C + TinyUSB 5 PCBs / 2 PCBA in turnkey job Y5
Parametric Fusion assembly + STEP/DXF 12 keys + encoder + touch + joystick Specialty parts consigned to the factory
Black POM, clear PMMA, 6061-T6, NBR 24 reverse-mount RGB pixels Flash, functional test, and evidence in SOP
Controlled drawing pack 0 DRC violations / 0 unconnected nets Customer closes only a few enclosure screws
Fusion 360 top view
FUSION 360 / TOP — measured mechanical interface
Fusion 360 side view
FUSION 360 / SIDE — corrected 5° wedge
CODEX KEYBORED PCB top
PCB / TOP — WORK LOAFER EDITION silk
Populated PCB underside
PCB / BOTTOM — controller island, power, matrix, RGB

Yes: the factory does the hand work

ZERO SOLDERING AT HOME. The production route asks JLC to place both-side SMD, manually install the twelve switches and encoder, fit the joystick/FFC, flash the STM32, exercise all 20 USB HID events, inspect all 24 RGB emitters, and install the caps on the primary unit. The customer-facing operation is enclosure closure after first-article approval.

The automatic JLC matcher uses the catalog-only BOM and CPL. The complete manual/secondary-operation contract is in the turnkey SOP, expanded BOM, 74-position CPL, and consigned-parts manifest.

SOURCE SPECIALTY PARTS  →  BOTH-SIDE PCBA  →  MANUAL CONTROLS
         →  FLASH + FUNCTION TEST  →  PHOTO EVIDENCE  →  ENCLOSURE CLOSURE

Live manufacturing snapshot

Quotes were captured in an authenticated JLC session on July 17, 2026. Prices are dynamic and exclude possible tax, duty, and engineering-review additions.

Job Configuration Captured price
CM2-001 upper housing CNC polished black POM, qty 1 $88.97
CM2-002 angled weight CNC 6061-T6, 5° wedge + G‑65 groove, qty 1 $68.31
CM2-003 light pipe CNC clear cast PMMA, polished edges + frosted face, qty 1 $45.70
CM2-004 joystick cap CNC POM fit prototype, qty 1 $19.42
CM2-005 continuous grip ring JLCMC AMFG-P5-A65-65 / black NBR 65A, qty 1 $0.16
Mechanical subtotal Four current CNC parts + purchased ring $222.56
JLCPCB turnkey base Five PCBs + two both-side Standard PCBA $193.01
Captured manufacturing floor Mechanical merchandise + PCBA base, before manual review, special parts, tax/duty/shipping $415.57

JLCPCB turnkey quote configuration JLCCNC Rev B ring-groove base quote

The $193.01 PCB/PCBA figure is a captured base, not a promise of a finished-device total. Programming, functional test, secondary manual operations, and consigned-part handling remain quote-after-review. The saved cart proves that the geometry and six-layer board can enter the vendor workflow; JLC engineering approval is still the gate before payment.

What is actually in the repository

Area Source of truth Ready-to-send artifact
Fusion mechanics fusion/build_codex_micro_mechanical.py Codex_Micro_RevA.f3d
CNC geometry Fusion BRep bodies cnc/STEP/ + cnc/DXF/
CNC dimensions Parametric model + controlled notes CM2_CNC_Drawing_Pack_RevB.pdf
PCB connectivity/layout codex_micro_wired_revA.kicad_pcb Gerber/drill ZIP
Assembly data Board-derived generator JLC BOM + JLC CPL
Principle schematic Final routed connectivity Three-sheet PDF + IPC-D-356
Firmware firmware/stm32/ BIN + HEX + checksums
Factory contract Mechanics Rev B + electronics Rev A2 Complete order handoff ZIP + mechanical factory ZIP
Full report Evidence, screenshots, prices, sources Single-page dossier + Rev B PDF

Electrical architecture

  • STM32F072CBT6, 128 KB flash, crystal-less HSI48 + CRS USB.
  • USB-C device input, dual 5.1 kΩ CC resistors, USBLC6 ESD protection.
  • Six layers: F.Cu, GND plane, two signal layers, +5V plane, B.Cu.
  • Twelve low-profile matrix switches plus clickable encoder.
  • Capacitive touch and two-channel analog planar joystick.
  • 24 × SK6812MINI-E: twelve per-key, nine underglow, three status.
  • Build-verified TinyUSB firmware with BIN/HEX/ELF artifacts and a browser factory test.
  • Housing interface intentionally remains compatible with a future replacement ESP32-S3/BLE board.

USB power and STM32 schematic Keyboard matrix and controls schematic

Mechanical datum set

The coordinate origin is the device center. +Y points toward the rear edge; +Z points upward.

Parameter Value Confidence Basis
Key pitch 19.05 mm CONFIRMED Work Louder MX keycap specification
Installed keyboard switches 12 CONFIRMED Visible layout + Creator Micro 2 specification
Total mechanical switch inputs 13 CONFIRMED Includes encoder push
Outer envelope 108 × 108 mm MEASURED Official top render scaled from key centers
Top PCB/panel 90 × 90 × 1.6 mm MEASURED / INFERRED Render scale + standard PCB thickness
PCB screw pitch 78 × 78 mm MEASURED Provisional ±0.5 mm
Upper housing 108 × 108 × 10.3 mm, R14 MEASURED Public front/side/top renders
Aluminum bottom Ø94 mm, 3.8→12.0 mm, 5° MEASURED / INFERRED Side profile + CNC construction
G‑65 retention groove Ø67.5 mm centerline × 3.6 W × 2.2 D ENGINEERED G‑65 section, screw clearance, 1.6 mm minimum Al floor
Continuous grip ring JIS B 2401 G‑65, ID 64.4, section 3.1, OD 70.6 mm PURCHASED / VERIFIED JLCMC AMFG-P5-A65-65
Joystick candidate Alps RKJXY1000006 CANDIDATE Available electrical/mechanical sibling

Confidence language is deliberate:

  • CONFIRMED — explicitly published by OpenAI, Work Louder, or a component manufacturer.
  • MEASURED — scaled from a public, near-orthographic product render.
  • INFERRED — a manufacturable placeholder that still requires physical first-article inspection.
  • ENGINEERED — a derived interface sized from known parts, tolerances, and adjacent clearances.
  • PURCHASED / VERIFIED — an exact orderable catalog part with checked dimensions and a live cart entry.

CNC material directions

The current quoted Rev B build uses polished black POM for the upper housing and joystick cap, black-anodized 6061-T6 for the 5° base, clear cast PMMA for the captured light pipe, and a purchased black NBR G‑65 ring. A wood upper remains a future material experiment, but it is not the current cart configuration.

All four STEP files passed JLC's automated CNC import. The current bottom was explicitly corrected from an early flat disc to the observed 5° wedge, then revised again with the G‑65 retention groove before the $68.31 configuration was saved. Obsolete flat/no-groove parts and individual rubber feet were removed from the cart.

Reproduce it

  1. Open or create the Fusion document named Codex, then run fusion/build_codex_micro_mechanical.py.
  2. Export/audit CNC bodies with the scripts in fusion/ and compare them with the controlled drawing pack.
  3. Open the board in KiCad 10 and verify the committed DRC report before regenerating fabrication data.
  4. Build the STM32 target from firmware/stm32/ or use the checksummed release image.
  5. Upload the Gerber ZIP, JLC BOM/CPL, CNC STEP files, drawing pack, and turnkey factory ZIP.
  6. Do not authorize production until JLC DFM, polarity/rotation, manual-operation scope, and first-article dimensions are reviewed.

Prototype status and provenance

This is an independent private prototype, reconstructed from official public product renders and published platform/component documentation. It is not an official OpenAI or Work Louder CAD/electronics release, is not affiliated with or endorsed by either company, and contains no leaked manufacturing data.

The digital production gate is clean: Gerbers, drill files, BOM/CPL, IPC netlist, three-sheet principle schematic, firmware, STEP/DXF, drawings, and vendor quote evidence are present. The physical gate is still open: no fabricated Rev A2 board has completed electrical bring-up, EMC evaluation, or dimensional fit-check. Use a current-limited supply, verify the 3.3 V rail and SWD first, and treat the first order as an engineering prototype.

Primary research links and detailed source notes live in the manufacturing dossier and firmware-and-compliance-notes.md.


PRESS KEYS. SHIP BUGS.

CODEX KEYBORED / WORK LOAFER EDITION / MECHANICS REV B + ELECTRONICS REV A2

About

A 100% vibe-coded hardware build: Fusion 360, six-layer KiCad PCB, STM32 firmware, and live JLC factory handoff.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors