From 1adf9f9c441b0cd5f280c3ad63a501cb598e32cd Mon Sep 17 00:00:00 2001
From: Daniel Esteban <conejo@theninjabunny.com>
Date: Tue, 14 Apr 2026 19:30:42 +0200
Subject: [PATCH] updates

---
 README.md | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 4c756a0..9c8c84a 100644
--- a/README.md
+++ b/README.md
@@ -33,12 +33,29 @@ badgeconf/
 ├── hardware/          # KiCad PCB design files
 │   └── PCB-kicad/
 │       └── production/  # Gerbers, BOM, pick-and-place files
-├── firmware/          # Ready-to-use TinyGo firmware (coming soon)
 └── tutorials/         # Step-by-step examples (coming soon)
 ```
 
 ---
 
+## Firmware
+
+BadgeConf ships two ready-to-use firmwares:
+
+### Demo firmware (conference)
+
+A showcase firmware that demonstrates all badge peripherals — LEDs, display, buttons, joystick, buzzer, and BLE. Ideal for conferences and as a starting point for your own experiments.
+
+Repository: [code.madriguera.me/GoEducation/badges](https://code.madriguera.me/GoEducation/badges)
+
+### HID firmware
+
+Turns the badge into a fully functional USB/Bluetooth keyboard. Built on top of [sago35/keyboards](https://github.com/sago35/keyboards), a TinyGo framework for custom keyboards.
+
+Repository: [github.com/sago35/keyboards](https://github.com/sago35/keyboards)
+
+---
+
 ## Getting started
 
 ### Prerequisites
@@ -47,12 +64,6 @@ badgeconf/
 - [Go](https://go.dev/dl/) ≥ 1.22
 - A BadgeConf board (see hardware section below) or a compatible nice!nano dev board
 
-### Flash the default firmware
-
-```bash
-tinygo flash -target=nicenano ./firmware/
-```
-
 ---
 
 ## Hardware