# @stream-io/stream-chat-css

> Bundled CSS for Stream Chat web SDKs

Latest version **5.16.1** (published 2025-12-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @stream-io/stream-chat-css
pnpm add @stream-io/stream-chat-css
yarn add @stream-io/stream-chat-css
bun add @stream-io/stream-chat-css
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: no vulnerabilities; has provenance.

Warnings: low downloads; no types; no esm support; large bundle.

## Facts

| | |
|---|---|
| Version | 5.16.1 |
| Published | 2025-12-19 |
| First published | 2021-12-03 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 13.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8 |
| Author | GetStream |
| Maintainers | tbarbugli, tschellenbach, vishtree, stream-release-bot, vangalilea88, zita.szupera, caleb.murphy, martincupela |

## Links

- npm: https://www.npmjs.com/package/@stream-io/stream-chat-css
- Repository: https://github.com/GetStream/stream-chat-css
- Homepage: https://github.com/GetStream/stream-chat-css#readme
- Issues: https://github.com/GetStream/stream-chat-css/issues
- npm.io page: https://npm.io/package/@stream-io/stream-chat-css

## Recent versions

- 5.16.1 (latest) — 2025-12-19
- 5.0.0-rc.6 (rc) — 2024-09-13
- 3.16.0 (release-v3) — 2023-12-13
- 3.1.2 (release-3.1.x) — 2022-09-30
- 3.0.0-theming2.12 (theming2) — 2022-09-07
- 2.10.0-alpha.0 (nnbb) — 2022-05-25
- 5.16.0 — 2025-10-17
- 5.15.0 — 2025-10-10
- 5.14.1 — 2025-10-09
- 5.14.0 — 2025-09-29
- 5.13.0 — 2025-09-26
- 5.12.0 — 2025-08-08
- 5.11.2 — 2025-07-23
- 5.11.1 — 2025-06-23
- 5.11.0 — 2025-06-12
- … 135 more at https://npm.io/package/@stream-io/stream-chat-css/versions

## README

# Stream Chat CSS

<div align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/19dd203e-c84a-4015-9c90-1a54212fc2e2">
    <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/fb6b6686-ce5d-4c8f-87b7-9bb495b6ce66">
    <img src="https://github.com/user-attachments/assets/19dd203e-c84a-4015-9c90-1a54212fc2e2" width="360" alt="Stream logo">
  </picture>
  <h3>Beautiful, ready-to-use styling for Stream Chat SDKs</h3>
  
  [![NPM](https://img.shields.io/npm/v/@stream-io/stream-chat-css.svg)](https://www.npmjs.com/package/@stream-io/stream-chat-css)
  [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/GetStream/stream-chat-css/blob/main/LICENSE)
  [![Build Status](https://img.shields.io/github/workflow/status/GetStream/stream-chat-css/CI/main)](https://github.com/GetStream/stream-chat-css/actions)
</div>

## 📝 Overview

Stream Chat CSS provides a comprehensive set of styles that power the UI components in [Stream](https://getstream.io/)'s Chat SDKs. This package is designed to make implementing beautiful, responsive chat interfaces straightforward and consistent.

- 🎨 **Complete Styling** - All the CSS you need to build full-featured chat applications
- 🧩 **Component-Based** - Organized by UI component for easy customization
- 🌈 **Themeable** - Extensive design system with customizable variables
- 🌐 **Cross-Browser Support** - Works across all modern browsers and devices
- 🧿 **Accessibility** - Built with a11y best practices

## 🚀 Installation

```bash
# With npm
npm install --save @stream-io/stream-chat-css

# With yarn
yarn add @stream-io/stream-chat-css

# With pnpm
pnpm add @stream-io/stream-chat-css
```

## 💻 Usage

This package comes as a dependency of `stream-chat-react` and doesn't require explicit installation if you're already using the React component library.

### Adding the styles to your app

Simply import the bundled CSS into your application:

```tsx
import '@stream-io/stream-chat-css/dist/css/index.css';
```

### Custom Theming

Stream Chat CSS supports customization through CSS variables. You can override the default theme by setting your own values for the CSS variables.

```css
:root {
  --str-chat__primary-color: #00b7ff;
  --str-chat__secondary-color: #1a1a1a;
  /* More customizations here */
}
```

## 🔍 Why Choose Stream?

[Stream](https://getstream.io) powers chat and activity feeds for over 1 billion end users. Our robust, scalable platform helps you build:

- **In-app Messaging** - Group chats, direct messaging, channels
- **Team Collaboration** - Slack-like workspaces and threaded conversations
- **Live Streaming** - Interactive live streams with chat
- **Virtual Events** - Engaging event platforms with rich chat features
- **Gaming Communities** - Community building with real-time chat
- **Support Channels** - Customer support with integrated chat

### ✨ Try Stream for Free

Ready to add chat to your application? [Sign up for a free Stream account](https://getstream.io/chat/trial/) and start building today!

* Free tier for smaller applications and testing
* Comprehensive documentation and tutorials
* Enterprise-grade security and compliance
* Dedicated support for paid plans

**[🔗 Check out our interactive demos →](https://getstream.io/chat/demos/)**

## 👩‍💻 We're Hiring!

We've [raised $38 million in Series B funding](https://techcrunch.com/2021/03/04/stream-raises-38m-as-its-chat-and-activity-feed-apis-power-communications-for-1b-users/) and are actively expanding our team of talented engineers.

Join us in building communication APIs used by over a billion end-users. You'll have the opportunity to make a significant impact on our products alongside some of the best engineers from around the world.

[**View Open Positions →**](https://getstream.io/team/#jobs)

## 🔣 Icons - for Stream Developers

- The icons for UI components can be exported from [Figma](https://www.figma.com/files/project/42134328/SDK-Teams-support-files?fuid=1038443988589634784)
- Icons are used as fonts, the font files are located in `src/assets/icons`
- If you need to change icons you have to regenerate the icon fonts:

1. Go to [https://fontello.com/](https://fontello.com/)
2. Upload the `svg` font from `src/assets/icons`
3. Edit the font
4. Set the font name to `stream-chat-icons` and the CSS prefix to `str-chat__icon--`
5. Download the font, and copy the content of the `font` folder to `src/assets/icons`, and copy the mapping from `css/stream-chat-icons.css` to `src/v2/Icon/Icon-layout.scss`

## 📄 License

MIT © [Stream.io Inc.](https://getstream.io)

---
_Source: https://npm.io/package/@stream-io/stream-chat-css · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
