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

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

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

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.

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.

Deployed version: https://feeds-react-tutorial-getstreamio.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:

NEXT_PUBLIC_API_KEY=your_api_key_here
API_SECRET=your_API_secret

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

yarn dev

You can provide user_id=<user id> query param when opening the app, or provide nothing, and let the application generate a user for you.

The test-data-generator directory contains scripts to populate your Stream Feeds app with sample data for testing and development purposes.

1. Create a .env file in test-data-generator/ with your credentials:

STREAM_API_KEY=<Stream API key>
API_SECRET=<Stream API secret>
API_URL=<Optional, Stream API URL>

2. Install dependencies: yarn (from the repository root)

Run these scripts in the following order from test-data-generator folder:

yarn create-users
yarn create-follows
# Optional, for hashtag feeds (run before create-posts when using --features hashtags).
yarn create-hashtag-group
# Adjust what features you need
yarn create-posts --features link,hashtags,attachment,mention,poll,reaction,comment,bookmark,repost
# Optional, only useful if you have story feeds
yarn create-stories
# Optional, if you want premium posts too
yarn create-premium-membership
yarn create-premium-members
yarn create-premium-posts
# Optional, adds 4 location-tagged posts (2 Amsterdam, 2 Boulder) with fun facts
yarn create-location-posts

Run these commands from the test-data-generator/ directory:

The create-posts script supports a --features flag to control which features are included in the generated posts:

yarn create-posts --features <feature1,feature2,...>

Available features:

Examples:

# Create basic posts without any features
yarn create-posts

# Create posts with polls and reactions
yarn create-posts --features poll,reaction

# Create posts with links and hashtags (run create-hashtag-group first)
yarn create-posts --features link,hashtags

# Create posts with all content features
yarn create-posts --features link,hashtags,attachment,mention,poll,reaction,comment,bookmark,repost

Note: Each feature has a probability of being included (not every post will have every enabled feature). Link and attachment are mutually exclusive per post. The hashtags feature only applies when a link is added to a post.

The create-location-posts script creates 4 activities and adds each to a randomly selected user's user feed:

• 2 for Amsterdam — location: lat 52.3676, lng 4.9041; text is a fun fact about Amsterdam.
• 2 for Boulder, Colorado — location: lat 40.015, lng -105.2705; text is a fun fact about Boulder.

Each activity has location set (lat, lng) and post text set to a fun fact about the city. If present, one image per post is read from test-data-generator/images/location/amsterdam/ or test-data-generator/images/location/boulder/ (.jpg, .jpeg, or .png), uploaded to Stream, and attached to the activity. Run after create-users (and optionally after create-posts).

The download-images script downloads 100 sample images (from picsum.photos) into test-data-generator/images/. By default it skips images that already exist.

Examples:

# Re-download only image 42
yarn download-images --replace=42

# Re-download images 1, 5 and 10
yarn download-images --replace 1,5,10

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

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

yarn

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