# iOS Live Shopping Reference App > Build an iOS live shopping experience with Agora RTC. An iOS reference combining live merchant video, product selection and customer shopping flows. Requires configuration of Agora and the external commerce, authentication and media services used by the app. - Author: Agora - Updated: 2026-10-21 - Difficulty: Intermediate - Categories: rtc - Platforms: iOS, Swift - Use cases: Live Shopping, Live Streaming - Capabilities: Agora RTC, Live Video, Reference App - [Recipe page](https://recipes.agora.io/recipes/ios-live-shopping-reference-app) - [Implementation repository](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios) - [Source recipe](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios/blob/main/docs/ai/RECIPE.md) - [Raw source Markdown](https://raw.githubusercontent.com/AgoraIO-Community/referenceapp-liveshopping-ios/main/docs/ai/RECIPE.md) - [All recipes](https://recipes.agora.io/llms.txt) ## Implementation guide # iOS Live Shopping Reference App ## Overview Build an iOS live shopping experience with host video, audience viewing, and commerce-oriented live interaction. Repository: [AgoraIO-Community/referenceapp-liveshopping-ios](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios) ## Prerequisites and Setup 1. Review the app structure and user-flow documents before selecting the merchant and customer paths to implement. 2. Use the iOS project under `LiveCommerce/` and its `Podfile` to install the checked-in dependencies with CocoaPods, then configure Xcode signing. 3. Provision your own Agora project and the integrations used by the app: Firebase, Sign in with Apple, Apple Pay and Banuba where those features are enabled. Inspect the app's source to supply each service's configuration. 4. Run merchant and customer clients with test accounts and sandbox payment configuration. Start a merchant broadcast and join as a customer. ## What To Check - Verify the customer can see the merchant stream and selected product. - Test the product/cart/order flow with sandbox services, including cancellation and failure. - End the broadcast and confirm both media and storefront state update. ## Integration Notes The upstream README explicitly describes this as a reference with known bugs and no promise of fixes. It requires several external integrations; a single Agora App ID does not make it runnable. Use sandbox payment flows during validation. Keep App Certificates, customer secrets and privileged token generation on a trusted backend for production. Use only your own test credentials while configuring historical demos; do not commit them. Preserve the sample's existing dependency versions and lifecycle until a separate migration is tested. ## Source References - [README.md](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios/blob/main/README.md) - [LiveCommerce/Podfile](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios/blob/main/LiveCommerce/Podfile) - [documents/Reference-App-Structure.md](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios/blob/main/documents/Reference-App-Structure.md) - [documents/User-Flow-Description.md](https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios/blob/main/documents/User-Flow-Description.md) ## Validation Status This recipe was checked against the repository's source and setup documents. The platform build and live service/device flow have not been run as part of this documentation change. Complete the checks above in an environment with the required SDKs, hardware and service access before treating it as a validated deployment. ## Implementation Prompt ```text You are working in AgoraIO-Community/referenceapp-liveshopping-ios. Use docs/ai/RECIPE.md and its linked source files to adapt the iOS Live Shopping Reference App reference to this project. Start by inspecting the actual sample directory and configuration described above. Resolve its listed missing prerequisites before claiming it is runnable. Preserve the existing architecture and compatible dependency versions. Implement the recipe's feature-specific flow, permissions and resource cleanup. Use a trusted backend for privileged credentials and tokens in production. Run the repository-specific build or launch flow, then perform each What To Check item. Report the commands run, the observed results and anything blocked by service access, hardware or incomplete sample code. Do not claim live validation from a documentation or catalog build alone. ``` ## Recipe prompt You are implementing the "iOS Live Shopping Reference App" recipe in this project. Read the recipe markdown first: https://raw.githubusercontent.com/AgoraIO-Community/referenceapp-liveshopping-ios/main/docs/ai/RECIPE.md Use the source repository for cross-reference: https://github.com/AgoraIO-Community/referenceapp-liveshopping-ios Build this recipe into the user's app using the markdown as the implementation guide. Inspect related source files through the repository links when the recipe points to them. Ask before installing new dependencies.