diff --git a/rev1/README.md b/rev1/README.md
index fb5cf4f..ff705ac 100644
--- a/rev1/README.md
+++ b/rev1/README.md
@@ -1,25 +1,49 @@
-# 5x6 split keyboard
+# 5×6‑Split‑KB (rev1)
 
-I have been using the planck keyboard for 10 years and i find that i usually have to do awkward finger gymnastics to do shortcutr including numbers. This is an attempt at making a keyboard that is easier to use in those situations.
+An ergonomic split keyboard designed for comfort, low height, and simplicity—without thumb clusters or wrist rests.
 
-I choose to not have a thumb cluster since i don't find that very ergonomic to me.
+![Assembled halves with TRRS cable](./images/assembled.jpeg)
 
-## PCB
+## Design Philosophy
 
-### Front
+After using the Planck keyboard for over 10 years, I found that common shortcuts—especially involving numbers—often require awkward finger gymnastics. This keyboard is an attempt to create something more comfortable and intuitive in those situations.
 
-![images/front-pcb.png](images/front-pcb.png)
+I also chose to remove the thumb cluster entirely, as I personally don't find them ergonomic. This layout avoids strain and keeps all keys within easy reach of the fingers.
 
-### Back
+Key ergonomic decisions include:
 
-![images/back-pcb.png](images/back-pcb.png)
+- **Low Profile**: With a total height of just **19.4 mm**, no wrist rest is needed.
+- **Split Layout**: Modeled after the Ergodox, allowing natural shoulder-width hand positioning.
+- **No Thumb Cluster**: Reduces thumb strain by omitting thumb-specific keys.
 
-## 3D models
+## Specifications
 
-### Front dampener
+- **Layout**: 5 rows × 6 columns per side (ortholinear grid)
+- **Total Height**: 19.4 mm 
+- **Split Connection**: TRRS 3.5mm audio cable (easy to find and replace)
+- **Microcontroller**: Raspberry Pi Pico (one per half)
+- **PCB**: Reversible; same board used for both left and right
+- **Assembly Method**:
+  - Held together with **2×4 mm magnets**
+  - Requires **super glue** for final enclosure fit
 
-This piece sits between the PCB and the switches to dampen the sound of the switches.
+## Ordering Info
 
-`3d-models/front-dampener.stl`
+- You'll need to order **2× copies of the same PCB**
+- Designed for **AISLER**, but probably compatible with other PCB manufacturers.
+  - On aisler you can simply upload the kicad pcb file directly.
 
-![images/front-dampener.png](images/front-dampener.png)
+## Image Gallery
+
+Click to view:
+
+- [Top view](./images/top.jpg)
+- [Side profile showing 19.4mm height](./images/side.jpg)
+- [PCB close-up](./images/pcb.jpg)
+- [Assembled halves with TRRS cable](./images/assembled.jpeg)
+
+## 🔗 Firmware
+
+Firmware is based on **QMK**.
+
+A link to the readme file will be added here as soon as he firmware branch is merged into the main repository.