diff --git a/music_sync/cues.json b/music_sync/cues.json
new file mode 100644
index 0000000..53bf4d0
--- /dev/null
+++ b/music_sync/cues.json
@@ -0,0 +1,114 @@
+{
+  "_note": "Lighting cues for 'Hear My Hope' - Hazbin Hotel. Timestamps in seconds.",
+  "_effects": {
+    "fade": "Fade from current to target colour",
+    "set":  "Instant colour change",
+    "flash": "Flash colour N times",
+    "pulse": "Breathe/pulse effect",
+    "off":  "Lights off"
+  },
+  "cues": [
+    {
+      "t": 0.0,
+      "action": "set",
+      "color": "off",
+      "note": "Dark - before song starts"
+    },
+    {
+      "t": 2.5,
+      "action": "fade",
+      "color": "warm_white",
+      "duration": 3.0,
+      "note": "Gentle open - Charlie's hope theme begins"
+    },
+    {
+      "t": 10.0,
+      "action": "fade",
+      "color": "angel_gold",
+      "duration": 2.0,
+      "note": "Hopeful swell"
+    },
+    {
+      "t": 20.0,
+      "action": "fade",
+      "color": "hope_pink",
+      "duration": 2.0,
+      "note": "Charlie's optimism - pink warm tones"
+    },
+    {
+      "t": 35.0,
+      "action": "pulse",
+      "color": "heaven_blue",
+      "cycles": 2,
+      "period": 2.0,
+      "note": "Heaven motif enters"
+    },
+    {
+      "t": 50.0,
+      "action": "fade",
+      "color": "angel_gold",
+      "duration": 1.5,
+      "note": "Rising emotion"
+    },
+    {
+      "t": 65.0,
+      "action": "flash",
+      "color": "hellfire_red",
+      "times": 2,
+      "on_time": 0.3,
+      "off_time": 0.15,
+      "note": "Tension / Hell reminder"
+    },
+    {
+      "t": 67.0,
+      "action": "fade",
+      "color": "hope_pink",
+      "duration": 2.0,
+      "note": "Return to hope"
+    },
+    {
+      "t": 80.0,
+      "action": "fade",
+      "color": "warm_white",
+      "duration": 3.0,
+      "note": "Big chorus swells - full brightness warm"
+    },
+    {
+      "t": 95.0,
+      "action": "fade",
+      "color": "angel_gold",
+      "duration": 1.0,
+      "note": "Climax build"
+    },
+    {
+      "t": 105.0,
+      "action": "flash",
+      "color": "cold_white",
+      "times": 1,
+      "on_time": 0.5,
+      "off_time": 0.1,
+      "note": "Peak moment - burst of white"
+    },
+    {
+      "t": 106.0,
+      "action": "fade",
+      "color": "hope_pink",
+      "duration": 4.0,
+      "note": "Emotional resolution"
+    },
+    {
+      "t": 120.0,
+      "action": "fade",
+      "color": "warm_white",
+      "duration": 3.0,
+      "note": "Outro - gentle"
+    },
+    {
+      "t": 135.0,
+      "action": "fade",
+      "color": "off",
+      "duration": 5.0,
+      "note": "Fade to black at end"
+    }
+  ]
+}