Skip to content

Showcase Apps#

The Showcase is a full sample application for exploring Storyteller components, layouts and configuration. Start with the Quickstart when adding the SDK to your own app, then use the component and feature references for exact APIs.

This SDK repository also contains a minimal core example at packages/storyteller_sdk/example/.

SDK support and app requirements#

The four SDK packages declare Dart >=3.9.0 <4.0.0 and Flutter >=3.35.0. Core supports iOS 13.0+ and Android API 24+; the optional Google Ads and VAST Flutter plugins declare iOS 15.0+ and Android API 24+. These are plugin requirements, not a complete toolchain matrix for every app. From 12.1.2, Android apps also need Kotlin 2.1+, compileSdk 35+ and Android Gradle Plugin 8.6.0+, because the Storyteller Android 12.x line brings Jetpack Compose 1.11.4 (BOM 2026.06.01).

The released Showcase 12.2.0 uses all four SDK packages at 12.2.0, declares Flutter >=3.35.0 <4.0.0, and sets its Podfile to iOS 15.0. Its Android configuration uses Flutter-provided SDK/NDK values and a Gradle 8.12 wrapper. A newer public main may have different requirements. Follow the README and build configuration of the exact Showcase checkout you run, including compatible Xcode/Swift, Java/Gradle and Android tools. The Storyteller plugin podspecs declare Swift 6 language mode. Do not infer the SDK's minimum OS or a universal Java/Xcode version from a sample application's settings.

Configuration and expected result#

Use the API key and content IDs supplied for your tenant, and test on a supported Android/iOS device or emulator with network access. Keys and content configuration may be managed by your organization; follow the Showcase README for that app's setup. A successful initialization does not imply that the selected category or collection has available published content.

The Quickstart demonstrates initialization, bounded layout and loading/error/empty states. Use Troubleshooting to locate a failing step, and Changelog to compare your installed version with Unreleased development behavior. Public Showcase links are examples from a moving application, not a versioned SDK API contract.

Support#

Need help? Contact us at [email protected] with your SDK version, platform, failing step and a minimal reproduction.