> For the complete documentation index, see [llms.txt](https://docs.firework.com/firework-for-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.firework.com/firework-for-developers/android-sdk/integration-guide.md).

# Integration Guide for Android SDK

Start with [Getting Started](/firework-for-developers/android-sdk/integration-guide/getting-started.md) to add dependencies, obtain a client ID, and initialize the SDK. Then choose the display component and integration features your app needs.

## Display Components

| Component                 | Use case                                 | Guide                                                                                            |
| ------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `FwVideoFeedView`         | Browsable thumbnail carousel or grid     | [Video Feed](/firework-for-developers/android-sdk/integration-guide/configure-video-feed.md)     |
| `FwStoryBlockView`        | Inline story-style player                | [StoryBlock](/firework-for-developers/android-sdk/integration-guide/storyblock.md)               |
| `FwPlayerDeckView`        | Inline player cards with shopping panels | [Player Deck](/firework-for-developers/android-sdk/integration-guide/01-basic-usage-and-api.md)  |
| `FireworkSdk.startPlayer` | Direct fullscreen playback               | [Fullscreen Player](/firework-for-developers/android-sdk/integration-guide/fullscreen-player.md) |

See [Widgets Overview](/firework-for-developers/android-sdk/integration-guide/widgets.md) for comparisons and [Compose Support](/firework-for-developers/android-sdk/integration-guide/compose-support-android.md) for hosting SDK views in Compose.

## Content and Configuration

* [Feed Sources](/firework-for-developers/android-sdk/integration-guide/feed-sources.md): discovery, channels, playlists, playlist groups, SKU filters, and individual content.
* [ViewOptions](/firework-for-developers/android-sdk/integration-guide/configuration.md): builders, Kotlin DSL, defaults, and configuration precedence.
* [Video Player](/firework-for-developers/android-sdk/integration-guide/video-player.md): playback, sharing, PiP, and player UI.
* [Deep Linking](/firework-for-developers/android-sdk/integration-guide/video-deep-linking.md): open content from shared URLs.

## Commerce and Interactions

* [Shopping](/firework-for-developers/android-sdk/integration-guide/shoppable-videos.md): product cards, hydration, cart/checkout callbacks, and purchase tracking.
* [Livestream](/firework-for-developers/android-sdk/integration-guide/livestream.md): player setup, interaction callbacks, and chat.
* [Video CTA](/firework-for-developers/android-sdk/integration-guide/cta.md) and [Social Links](/firework-for-developers/android-sdk/integration-guide/social-link.md): handle navigation and configure appearance.
* [Analytics](/firework-for-developers/android-sdk/integration-guide/analytics.md): event registration, payloads, and widget attribution.

## Reference and Support

* [FireworkSdk API](/firework-for-developers/android-sdk/integration-guide/firework-sdk-api.md)
* [FAQ & Troubleshooting](/firework-for-developers/android-sdk/faq-and-troubleshooting.md)
* [Changelog](/firework-for-developers/android-sdk/changelog.md)