fix: building on old xcode, code examples

Author: okwasniewski

README.md

@@ -22,15 +22,25 @@ npm install @callstack/liquid-glass
 yarn add @callstack/liquid-glass
 ```
 
+> [!WARNING]
+> Make sure to compile your app with Xcode >= 26.
+
 ### Usage
 
 ```tsx
 import { LiquidGlassView } from '@callstack/liquid-glass';
 
+// Handle fallback for unsupported iOS versions
+const supportsLiquidGlass =
+  Platform.OS === 'ios' && Number(Platform.Version.split('.').at(0)) >= 26;
+
 function MyComponent() {
   return (
     <LiquidGlassView
-      style={{ width: 200, height: 100, borderRadius: 20 }}
+      style={[
+        { width: 200, height: 100, borderRadius: 20 },
+        !supportsLiquidGlass && { backgroundColor: 'rgba(255,255,255,0.5)' },
+      ]}
       interactive
       effect="clear"
     >
@@ -40,6 +50,9 @@ function MyComponent() {
 }
 ```
 
+> [!NOTE]
+> On unsupported iOS version (below iOS 26), it will render a normal `View` without any effects.
+
 ### LiquidGlassView - Props
 
 | Prop          | Type                            | Default     | Description                                                                                                                         |
@@ -49,6 +62,10 @@ function MyComponent() {
 | `tintColor`   | `ColorValue`                    | `undefined` | Overlay color tint applied to the glass effect. Accepts any React Native color format (hex, rgba, named colors)                     |
 | `colorScheme` | `'light' \| 'dark' \| 'system'` | `'system'`  | Color scheme adaptation:<br/>• `light` - Light appearance<br/>• `dark` - Dark appearance<br/>• `system` - Follows system appearance |
 
+## Known issues
+
+- `interactive` prop is not changed dynamically, it is only set on mount.
+
 ## Made with ❤️ at Callstack
 
 `liquid-glass` is an open source project and will always remain free to use. If you think it's cool, please star it 🌟.

ios/LiquidGlassContainerView.mm

@@ -38,6 +38,8 @@ - (instancetype)initWithFrame:(CGRect)frame
   return self;
 }
 
+#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && __IPHONE_OS_VERSION_MAX_ALLOWED >= 260000 /* __IPHONE_26_0 */
+
 - (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
 {
   const auto &oldViewProps = *std::static_pointer_cast<LiquidGlassContainerViewProps const>(_props);
@@ -46,8 +48,6 @@ - (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &
   if (oldViewProps.spacing != newViewProps.spacing) {
     [_view setSpacing:newViewProps.spacing];
   }
-  
-
 
   [super updateProps:props oldProps:oldProps];
 }
@@ -59,6 +59,7 @@ - (void)mountChildComponentView:(UIView<RCTComponentViewProtocol> *)childCompone
 - (void)unmountChildComponentView:(UIView<RCTComponentViewProtocol> *)childComponentView index:(NSInteger)index {
   [childComponentView removeFromSuperview];
 }
+#endif
 
 @end
 

ios/LiquidGlassContainerView.swift

@@ -1,5 +1,6 @@
 import UIKit
 
+#if compiler(>=6.2)
 
 @objc public class LiquidGlassConatinerViewImpl: UIVisualEffectView {
   public override func layoutSubviews() {
@@ -20,3 +21,8 @@ import UIKit
   }
 }
 
+#else
+
+@objc public class LiquidGlassConatinerViewImpl: UIView {}
+
+#endif

ios/LiquidGlassView.mm

@@ -39,19 +39,19 @@ - (instancetype)initWithFrame:(CGRect)frame
 
   return self;
 }
+
+#if defined(__IPHONE_OS_VERSION_MAX_ALLOWED) && __IPHONE_OS_VERSION_MAX_ALLOWED >= 260000 /* __IPHONE_26_0 */
 - (void)layoutSubviews {
   [super layoutSubviews];
   _view.layer.cornerRadius = self.layer.cornerRadius;
   _view.layer.cornerCurve = self.layer.cornerCurve;
 }
 
-
 - (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
 {
   const auto &oldViewProps = *std::static_pointer_cast<LiquidGlassViewProps const>(_props);
   const auto &newViewProps = *std::static_pointer_cast<LiquidGlassViewProps const>(props);
 
-  
   if (oldViewProps.tintColor != newViewProps.tintColor) {
     _view.effectTintColor = RCTUIColorFromSharedColor(newViewProps.tintColor);
   }
@@ -113,4 +113,6 @@ - (void)unmountChildComponentView:(UIView<RCTComponentViewProtocol> *)childCompo
   [childComponentView removeFromSuperview];
 }
 
+#endif
+
 @end

ios/LiquidGlassView.swift

@@ -1,6 +1,8 @@
 import UIKit
 
 
+#if compiler(>=6.2)
+
 @available(iOS 26.0, *)
 @objc public class LiquidGlassViewImpl: UIVisualEffectView {
   @objc public var effectTintColor: UIColor?
@@ -20,3 +22,10 @@ import UIKit
     self.effect = glassEffect
   }
 }
+
+#else
+
+@objc public class LiquidGlassViewImpl: UIView {}
+
+#endif
+