diff --git a/README.md b/README.md
index 089d0ab..3b9b1cc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,47 @@
 # N1-E
+
 The design and specs for the N1-E
+
+# Software
+
+| Name          | Language  | Frameworks   | Role                                               | Runs in         |
+| ------------- | --------- | ------------ | -------------------------------------------------- | --------------- |
+| UI controller | Rust / TS | OSUI / React | Aircraft ground control                            | Ground computer |
+| Main SBC      | Rust      | RPI          | MCU handling and telemetry                         | SBC             |
+| Flasher       | Python    | RPI          | MCU flashing and SBC flashing                      | SBC             |
+| Motor MCU     | Rust      | RP2040       | Handles motor speed and motor RPMs and temperature | Motor MCU       |
+| Aero MCU      | Rust      | RP2040       | Handles servos for aero control                    | Aero MCU        |
+
+# Hardware
+
+## Computational hardware
+
+| Name      | Role                                               |
+| --------- | -------------------------------------------------- |
+| SBC       | Controls all the systems                           |
+| Motor MCU | Handles motor speed and motor RPMs and temperature |
+| Aero MCU  | Handles servos for aero control                    |
+| Aero MCU  | Handles servos for aero control                    |
+
+## Other hardware
+
+| Name    | Details                        |
+| ------- | ------------------------------ |
+| Motor   | 4023 outrunner, ~850 kV        |
+| Battery | 3S LiPo 2200–3300 mAh (30–45C) |
+| ESC     | 30 A brushless ESC with BEC    |
+
+# Diagram
+
+```mermaid
+flowchart TD
+    A[SBC] --> B[Motor MCU]
+    A --> C[Aero MCU]
+    B --> D[Motor]
+    C --> E[Servo]
+
+    classDef success stroke:#20c,stroke-width:2px;
+
+    class D success;
+    class E success;
+```