Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Amazon IVS React Feed app

A demo web application intended as an educational tool for demonstrating how you can build a very simple scrolling feed app, load and auto-play Amazon IVS live streams as users scroll down the page. This project was bootstrapped with Create React App.

Amazon IVS Feed demo

This project is intended for education purposes only and not for production usage.

Getting Started

In the project directory, run:


Installs the dependencies of the project.

yarn start

Runs the app in the development mode. Open http://localhost:3000 to view it in your browser.

The page will automatically reload as you make edits. You will also see any lint errors in the console.

Using your own Live streams

This demo loads streams and stream metadata from a local file (feed.json), which provides a json object containing an array of stream objects. Each stream object represents one video in the feed. To load your own IVS streams, you will need to modify feedJSON in the App.jsx file, to load your own json file, which should follow this structure:

  "streams": [
      "id": <unique-stream-id>,
      "stream": {
        "channelArn": "<channel-ARN>",
        "health": "HEALTHY",
        "playbackUrl": "<channel-playback-url>.m3u8",
        "startTime": "<stream-start-time>",
        "state": "<live-status>",
        "viewerCount": <viewer-count>
      "metadata": {
        "streamTitle": "<stream-title>",
        "userAvatar": "<streamer-avatar>",
        "userName": "<streamer-name>",
        "userColors": {
          "primary": "<streamer-color-1-hex>",
          "secondary": "<streamer-color-2-hex>"
      "id": 1,
      "stream": {

About Amazon IVS

Amazon Interactive Video Service (Amazon IVS) is a managed live streaming solution that is quick and easy to set up, and ideal for creating interactive video experiences. Learn more.


See CONTRIBUTING for more information.


This library is licensed under the MIT-0 License. See the LICENSE file.