diff --git a/README.md b/README.md
index 1c7b583..1d96861 100644
--- a/README.md
+++ b/README.md
@@ -23,11 +23,31 @@ Suggestions welcome. Open an issue or email [tgohle@togo-lab.io](mailto:tgohle@t
 
 ## Repo layout
 ```
-0001_FireFly/
-├─ KiCad/            # .kicad_pro, schematic, PCB, fabrication outputs
-├─ CAD/              # 2D/3D mechanical drawings, panel outlines (if any)
-├─ Program/          # firmware source, hex, Makefiles / Arduino sketches
-└─ Documentation/    # assembly guide, quick start, FAQ, photos, BOM CSV
+├── doc
+│   ├── assets                                              // pictures, diagrams..
+│   └── logs                                                // lab logs
+├── firmware
+│   ├── archive                                             // archive, derived from...
+│   │   └── ATTINY45_2014_MorseThrowie
+│   │       ├── ATTINY45_2014_MorseThrowie.ino
+│   │       └── pitches.h
+│   ├── include
+│   ├── FireFly_MorseBlinker                                // arduino IDE file
+│   └── src
+├── hardware
+│   ├── CAD                                                 // CAD files for mechanical work
+│   │   └── ToGo-Lab_FireFly_MorseThrowie.dxf
+│   └── KiCad                                               // KiCad project files
+│       └── 0001-FireFly
+│           ├── 0001-FireFly-backups
+│           │   ├── 0001-FireFly-2025-09-07_180819.zip
+│           │   └── 0001-FireFly-2025-09-07_181506.zip
+│           ├── 0001-FireFly.kicad_pcb
+│           ├── 0001-FireFly.kicad_prl
+│           ├── 0001-FireFly.kicad_pro
+│           └── 0001-FireFly.kicad_sch
+├── License_-_CC_BY-NC_4.0.md
+└── README.md
 ```
 
 ---
diff --git a/Program/ATTINY45_2014_MorseThrowie/ATTINY45_2014_MorseThrowie.ino b/firmware/archive/ATTINY45_2014_MorseThrowie/ATTINY45_2014_MorseThrowie.ino
similarity index 100%
rename from Program/ATTINY45_2014_MorseThrowie/ATTINY45_2014_MorseThrowie.ino
rename to firmware/archive/ATTINY45_2014_MorseThrowie/ATTINY45_2014_MorseThrowie.ino
diff --git a/Program/ATTINY45_2014_MorseThrowie/pitches.h b/firmware/archive/ATTINY45_2014_MorseThrowie/pitches.h
similarity index 100%
rename from Program/ATTINY45_2014_MorseThrowie/pitches.h
rename to firmware/archive/ATTINY45_2014_MorseThrowie/pitches.h
diff --git a/CAD/ToGo-Lab_FireFly_MorseThrowie.dxf b/hardware/CAD/ToGo-Lab_FireFly_MorseThrowie.dxf
similarity index 100%
rename from CAD/ToGo-Lab_FireFly_MorseThrowie.dxf
rename to hardware/CAD/ToGo-Lab_FireFly_MorseThrowie.dxf
diff --git a/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_180819.zip b/hardware/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_180819.zip
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_180819.zip
rename to hardware/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_180819.zip
diff --git a/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_181506.zip b/hardware/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_181506.zip
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_181506.zip
rename to hardware/KiCad/0001-FireFly/0001-FireFly-backups/0001-FireFly-2025-09-07_181506.zip
diff --git a/KiCad/0001-FireFly/0001-FireFly.kicad_pcb b/hardware/KiCad/0001-FireFly/0001-FireFly.kicad_pcb
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly.kicad_pcb
rename to hardware/KiCad/0001-FireFly/0001-FireFly.kicad_pcb
diff --git a/KiCad/0001-FireFly/0001-FireFly.kicad_prl b/hardware/KiCad/0001-FireFly/0001-FireFly.kicad_prl
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly.kicad_prl
rename to hardware/KiCad/0001-FireFly/0001-FireFly.kicad_prl
diff --git a/KiCad/0001-FireFly/0001-FireFly.kicad_pro b/hardware/KiCad/0001-FireFly/0001-FireFly.kicad_pro
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly.kicad_pro
rename to hardware/KiCad/0001-FireFly/0001-FireFly.kicad_pro
diff --git a/KiCad/0001-FireFly/0001-FireFly.kicad_sch b/hardware/KiCad/0001-FireFly/0001-FireFly.kicad_sch
similarity index 100%
rename from KiCad/0001-FireFly/0001-FireFly.kicad_sch
rename to hardware/KiCad/0001-FireFly/0001-FireFly.kicad_sch