Guides

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.

Start here

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 in App Router	Next.js App Router app with server-personalized first paint and browser re-resolution after hydration	`@contentful/optimization-nextjs`
Next.js SDK in Pages Router	Next.js Pages Router app with `getServerSideProps` personalization and state handoff	`@contentful/optimization-nextjs`

Native and mobile SDK guides route to beta SDK 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`

Building a custom JavaScript Optimization adapter - Build a low-level adapter only when no official SDK package fits your JavaScript runtime or framework.
Forwarding Optimization SDK context to analytics and tag-management tools - Forward optimization context to analytics, tag-management, customer-data, or product-analytics tools after SDK integration.