From bb61598becd6b7d8efcccd34319d7dbeb03c58c0 Mon Sep 17 00:00:00 2001
From: harcop <harcopdrew@gmail.com>
Date: Mon, 1 Sep 2025 19:47:13 +0100
Subject: [PATCH] add removeClippedSubviews option to ResponsiveGrid

---
 src/responsive-grid/index.tsx | 2 ++
 src/responsive-grid/types.ts  | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/src/responsive-grid/index.tsx b/src/responsive-grid/index.tsx
index 01c1f79..034254f 100644
--- a/src/responsive-grid/index.tsx
+++ b/src/responsive-grid/index.tsx
@@ -34,6 +34,7 @@ export const ResponsiveGrid: React.FC<ResponsiveGridProps> = ({
   HeaderComponent = null,
   FooterComponent = null,
   direction = 'ltr',
+  removeClippedSubviews = true,
 }) => {
   const [visibleItems, setVisibleItems] = useState<TileItem[]>([]);
 
@@ -239,6 +240,7 @@ export const ResponsiveGrid: React.FC<ResponsiveGridProps> = ({
           width: '100%',
         }}
         showsVerticalScrollIndicator={showScrollIndicator}
+        removeClippedSubviews={removeClippedSubviews}
       >
         {/* Render HeaderComponent if provided */}
         <View
diff --git a/src/responsive-grid/types.ts b/src/responsive-grid/types.ts
index eaf26ef..e7ef86f 100644
--- a/src/responsive-grid/types.ts
+++ b/src/responsive-grid/types.ts
@@ -85,6 +85,13 @@ export interface ResponsiveGridProps {
    * @default ltr
    */
   direction?: 'rtl' | 'ltr';
+
+  /**
+   * When true, off-screen child views (whose overflow value is hidden) are automatically removed from the native view hierarchy.
+   * This can improve performance for long lists, especially on Android when rendering remote images.
+   * @default true
+   */
+  removeClippedSubviews?: boolean;
 }
 
 export interface TileItem {