From a8d56b92206c0fc79ba04905583e2859ac59261b Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com>
Date: Tue, 4 Nov 2025 02:31:01 +0000
Subject: [PATCH] Document light/dark mode override for iOS paywalls

---
 sdk/quickstart-ios.mdx | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/sdk/quickstart-ios.mdx b/sdk/quickstart-ios.mdx
index 6e1a281..f014de6 100644
--- a/sdk/quickstart-ios.mdx
+++ b/sdk/quickstart-ios.mdx
@@ -641,6 +641,25 @@ Helium.shared.initialize(
   </Tip>
 </Accordion>
 
+<Accordion title="Set a custom light mode/dark mode setting for paywalls">
+  By default, paywalls follow your device's appearance setting (light or dark mode), if you've configured it in the editor. You can override this behavior to force a specific mode (e.g., if your app has its own dark mode/light mode scheme):
+
+  ```swift
+  // Force light mode for all paywalls
+  Helium.shared.setLightDarkModeOverride(.light)
+
+  // Force dark mode for all paywalls
+  Helium.shared.setLightDarkModeOverride(.dark)
+
+  // Reset to system default (respects device setting)
+  Helium.shared.setLightDarkModeOverride(.system)
+  ```
+
+  <Note>
+    The override persists until changed and applies to all paywalls. Call this during app initialization or before presenting paywalls.
+  </Note>
+</Accordion>
+
 <Accordion title="Reset Helium">
   Reset Helium entirely so you can call initialize again. Only for advanced use cases.