diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
new file mode 100644
index 0000000..5df5b2b
--- /dev/null
+++ b/docs/TROUBLESHOOTING.md
@@ -0,0 +1,3 @@
+# 🛠️ Troubleshooting Guide
+
+Resolving Vulkan/D3D11 rendering glitches, subtitle font caching, and audio track switching.