Use this index to pick the guide that matches your SDK runtime. Start with package selection when you are unsure which SDK layer belongs in your app.
Server and web SDK guides are listed before native and mobile SDK guides.
| Guide | Runtime or app type | Package |
|---|---|---|
| Node SDK | Node server, custom SSR server, or server-side function | @contentful/optimization-node |
| Web SDK | Browser app, static site, multi-page app, SPA, Angular app, or custom frontend runtime | @contentful/optimization-web |
| React Web SDK | React browser app | @contentful/optimization-react-web |
| Next.js SDK (SSR) | Next.js App Router app where the server chooses the rendered variant | @contentful/optimization-nextjs |
| Next.js SDK (hybrid SSR + CSR takeover) | Next.js App Router app with server-personalized first paint and browser re-resolution after hydration | @contentful/optimization-nextjs |
Native iOS and Android guides route to pre-release alpha surfaces.
| Guide | Runtime or app type | Package |
|---|---|---|
| React Native SDK | React Native or Expo mobile app | @contentful/optimization-react-native |
| iOS SDK in SwiftUI | Native iOS app built with SwiftUI | ContentfulOptimization Swift Package |
| iOS SDK in UIKit | Native iOS app built with UIKit | ContentfulOptimization Swift Package |
| Android SDK in Jetpack Compose | Native Android app built with Jetpack Compose | com.contentful.java:optimization-android |
| Android SDK in Android Views | Native Android app built with Android Views or XML layouts | com.contentful.java:optimization-android |