Stream Feeds for JavaScript, React and React Native

Bring users together through personalized feeds, threaded discussions, and real-time updates that make every interaction feel meaningful.

Quick Links

• Register to get an API key for Stream Feeds
• React SDK
• React Native SDK
• JavaScript SDK
• React sample apps
• React native sample app
• Docs

What is Stream?

Stream allows developers to rapidly deploy scalable feeds, chat messaging and video with an industry leading 99.999% uptime SLA guarantee.

Stream's Activity Feed V3 SDK enables teams of all sizes to build scalable activity feeds. The best place to get started is to follow one of the tutorials:

• React tutorial
• React Native tutorial

👩‍💻 Free for Makers 👨‍💻

Stream is free for most side and hobby projects. To qualify, your project/company needs to have < 5 team members and < $10k in monthly revenue. Makers get $100 in monthly credit for feeds for free.

💡 Supported Features 💡

Here are some of the features we support:

• For-You feed: Most modern apps combine a “For You” feed with a regular “Following” feed. With activity selectors you can:
  • surface popular activities
  • show activities near the user
  • match activities to a user’s interests
  • mix-and-match these selectors to build an engaging personalized feed.
• Comments: Voting, threading, images, URL previews, @mentions & notifications. Basically all the features of Reddit style commenting systems.
• Advanced feed features: Activity expiration • visibility controls • feed visibility levels • feed members • bookmarking • follow-approval flow • stories support.
• Activity filtering: Filter activity feeds with almost no hit to performance
• Search & queries: Activity search, query activities, and query feeds endpoints.
• Modern essentials: Permissions • OpenAPI spec • GDPR endpoints • realtime WebSocket events • push notifications • “own capabilities” API.

React sample apps

React demo app with stories

Deployed version: https://feeds-react-demo.vercel.app

Prerequisites:

• Install dependencies: yarn
• Build React SDK: yarn build:client and yarn build:react-sdk
• Create a .env file in sample-apps/react-demo with one of the following content:

Use this if you want to use a single user only:

NEXT_PUBLIC_API_KEY=your_api_key_here
NEXT_PUBLIC_USER_ID=your_user_id_here
NEXT_PUBLIC_USER_NAME=Your Name
NEXT_PUBLIC_USER_TOKEN=your_user_token_here

If your app is configured to accept development tokens, you can use dev tokens to test with muliple users, in this case just provide an API key:

NEXT_PUBLIC_API_KEY=your_api_key_here

If you have a token provider backend, you can also provide a URL that takes user_id as a query param:

NEXT_PUBLIC_API_KEY=your_api_key_here
NEXT_PUBLIC_TOKEN_URL=optional,no need for user info in this case

After the above steps run the following command in sample-apps/react-demo:

yarn dev

Advanced React app

Prerequisites:

• Install dependencies: yarn
• Build React SDK: yarn build:client and yarn build:react-sdk
• Create a .env file in sample-apps/react-sample-app with the following content:

NEXT_PUBLIC_STREAM_API_KEY=<Your API key>
NEXT_API_SECRET=<Your API secret>
NEXT_PUBLIC_API_URL=<Optionally provide an API URL>

• Run the node setup-env.js script in sample-apps/react-sample-app
• If you want to have some pre-made posts in your app, optinally run the node create-posts.js script as well

After the above steps run the following command in sample-apps/react-sample-app:

yarn dev

Local Setup

Prerequisites

You'll need to have node 22 installed on your computer

Install dependencies

In the repository root run the following command to install all dependencies of all packages in this monorepo:

yarn

Build and run JS client

cd packages/feeds-client
yarn build
# or
yarn start