# Activity Feeds
Stream Feeds powers social feeds: timelines, follow graphs, comments, reactions and notification feeds, delivered to clients in real time. These docs cover Feeds v3, the current generation.
## How the pieces fit together
Your app reads feeds and posts activities through a client SDK, which receives updates in real time over WebSocket. Your backend uses a [server-side SDK](https://getstream.io/activity-feeds/docs/node/) to define feed groups, manage follows and sign the [user tokens](https://getstream.io/docs/platform/authentication/) clients connect with.
```mermaid
flowchart LR
subgraph app[Your app]
client[Feeds client SDK]
end
subgraph backend[Your backend]
server[Server-side SDK]
end
client <--> api[Stream API]
server --> api
server -. user token .-> client
```
## SDKs
### Client Side SDKs
Read feeds, post activities and subscribe to real-time updates from your app.
### Server Side SDKs
Create feed groups, write activities and manage follows from your backend.
## Build with AI
Your AI agent can work with Stream from the terminal with the [Stream CLI](https://getstream.io/cli/docs/). There's also an [Agent Skills](https://getstream.io/agent-skills/docs/) pack so it can look up docs and configure your app.
```bash
curl -fsSL https://getstream.io/cli.sh | bash
getstream skills
```
## Platform
Users, auth and the rest of the account-level machinery work the same in every Stream product, so they are documented once in the [platform docs](https://getstream.io/docs/platform/). Feeds apps touch these first:
## Start here
Each tutorial builds a working social feed from an empty project. Pick your platform:
## FAQ
**What's the difference between Feeds v2 and v3?**
v3 is the current generation and what these docs cover. The [migration guide](https://getstream.io/activity-feeds/docs/node/v2-to-v3-migration/) covers moving a v2 app.
**Do feeds update in real time?**
Yes. Clients subscribe over WebSocket and receive activities, comments and reactions as they happen.
**Do I need my own backend?**
Yes. Your server defines feed groups and signs the [user tokens](https://getstream.io/docs/platform/authentication/) clients connect with.
**Can I use Feeds with Chat?**
Yes. Every Stream product shares the same app, users and tokens; the [platform docs](https://getstream.io/docs/platform/) cover them once.
**Can I read these docs as markdown?**
Append `.md` to any page URL. [/llms.txt](https://getstream.io/llms.txt) indexes every page.
---
This page was last updated at 2026-09-04T17:21:55.828Z.
For the most recent version of this documentation, visit [https://getstream.io/activity-feeds/docs/](https://getstream.io/activity-feeds/docs/).