diff --git a/README.md b/README.md
new file mode 100644
index 000000000..5d741c250
--- /dev/null
+++ b/README.md
@@ -0,0 +1,86 @@
+# Oracles
+
+## Mobile
+
+```mermaid
+flowchart TD
+    MI("`**Mobile Ingestor**
+        - Heartbeats (cbrs, wifi)
+        - Speedtests
+        - Data transfer sessions
+        - Subscriber Location Rewards (disco mapping)
+        - Coverage objects
+        - Radio thresholds (hip-84)
+    `")
+    MV("`**Mobile Verifier**
+        - Validates all incoming data 
+        - Calculates rewards at 01:30 UTC
+    `")
+    MPV("`**Mobile Packet Verifier**
+        - Burns DC for data transfer (on solana)
+    `")
+    MB("`**Mobile Price**
+        - Records Pyth price for MOBILE
+    `")
+    DB1[(Foundation owned db populated by helius)]
+    MC("`**Mobile Config**
+        - Provides access to on-chain data
+        - Stores pubkeys for remote systems
+    `")
+    MRI("`**Mobile Reward Index**
+        - Writes rewards to foundation db
+    `")
+    DB2[(Foundation owned db that stores reward totals)]
+    MI -- S3 --> MV
+    MI -- S3 --> MPV
+    MPV -- S3 --> MV
+    MB -- S3 --> MV
+    DB1 --> MB
+    MB --> MC
+    MC -- gRPC --> MV
+    MV -- S3 --> MRI
+    MRI --> DB2
+```
+
+## IOT
+
+```mermaid
+flowchart TD
+    DB1[(Foundation owned db populated by helius)]
+    IC("`**IOT Config**
+        - Provides access to on-chain data
+        - Stores pubkeys for remote systems
+        - Store orgs and routes used by Helium Packet Router
+    `")
+    HPR("`**Helium Packet Router**
+        - Ingest packets from Hotspots
+        - Deliver packets to LNS
+    `")
+    IPV("`**IOT Packet Verifier**
+        - Burns DC for data transfer (on solana)
+    `")
+    II("`**IOT Ingestor**
+        - Beacons
+        - Wtinesses
+        - Long lived grpc streams
+    `")
+    IV("`**IOT Verifier**
+        - Validates all incoming data 
+        - Calculates rewards at 01:30 UTC
+    `")
+    IE("`**IOT Entropy**
+        - Creates entropy used by gateways and iot-verifier
+    `")
+    IRE("`**IOT Reward Index**
+        - Writes rewards to foundation db
+    `")
+    DB2[(Foundation owned db that stores reward totals)]
+    DB1 --> IC
+    IC -- gRPC --> HPR
+    HPR -- s3 --> IPV
+    II -- s3 --> IV
+    IPV -- s3 --> IV
+    IE -- s3 --> IV
+    IV -- s3 --> IRE
+    IRE --> DB2
+```
\ No newline at end of file