From 75c939f36c7affeaa20d4edbffaee151effe961f Mon Sep 17 00:00:00 2001 From: Rudin Swagerman Date: Fri, 22 Aug 2025 14:54:14 +0200 Subject: [PATCH] Update installation guide with iOS simulator note Added a note about iOS simulator limitations for 3D rendering. --- docs/getting-started/installation.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/getting-started/installation.mdx b/docs/getting-started/installation.mdx index 801c536c73..9795af6e64 100644 --- a/docs/getting-started/installation.mdx +++ b/docs/getting-started/installation.mdx @@ -171,6 +171,9 @@ R3F's API is completely x-platform, so you can use [events](/api/events) and [ho > [!NOTE] > Make sure to import from `@react-three/fiber/native` or `@react-three/drei/native` for correct IntelliSense and platform-specific abstractions. +> [!NOTE] +> iOS simulators often have incomplete or unreliable OpenGL ES support, which can cause EXC_BAD_ACCESS crashes when rendering 3D content. Always test on a physical iOS device (iPhone/iPad running iOS 16 or later) to ensure stable WebGL rendering. + ```jsx import { Suspense } from 'react' import { Canvas } from '@react-three/fiber/native'