GetStream / stream-chat-angular

💬 Angular Chat SDK ➜ Stream Chat. Build a chat app with ease.
https://getstream.io/chat/sdk/angular/
54 stars 32 forks source link
angular angular-api angular-chat angular-chat-application angular-components angular-library chat chat-sdk getstream getstream-io ui

Official Angular SDK for Stream Chat

The official Angular components for Stream Chat, a service for building chat applications.

tests and release workflow

Quick Links

With our component library, you can build a variety of chat use cases, including:

Angular Chat Tutorial

The best way to get started is to follow the Angular Chat Tutorial. It shows you how to use this SDK to build a fully functional chat application and includes common customizations.

Free for Makers

Stream is free for most side and hobby projects. To qualify, your project/company must have no more than 5 team members and earn less than $10k in monthly revenue. For complete pricing and details visit our Chat Pricing Page.

Docs

The docs provide a brief description about the components and services in the library.

The Angular library is created using the stream-chat-js library. For the most common use cases our services should give a nice abstraction over this library, however you might need it for more advanced customization, the documentation is on our website.

Contributing

We welcome code changes that improve this library or fix a problem. Please make sure to follow all best practices and add tests, if applicable, before submitting a pull request on GitHub. We are pleased to merge your code into the official repository if it meets a need. Make sure to sign our Contributor License Agreement (CLA) first. See our license file for more details.

We are hiring.

We recently closed a $38 million Series B funding round and are actively growing. Our APIs are used by more than a billion end-users, and by working at Stream, you have the chance to make a huge impact on a team of very strong engineers.

Check out our current openings and apply via Stream's website.

Installation

Install with NPM

Supported Angular versions: Angular 15-18

Run this command if you are using Angular 18:

npm install stream-chat-angular stream-chat ngx-float-ui@18

Run this command if you are using Angular 17:

npm install stream-chat-angular stream-chat ngx-float-ui@17

Run this command if you are using Angular 16:

npm install stream-chat-angular stream-chat ngx-float-ui@16

Run this command if you are using Angular 15:

npm install stream-chat-angular stream-chat @ngx-translate/core@14 ngx-float-ui@15

Supported node verisons: 18+

Sample App

This repository includes a sample app to test our library.

To test the app:

Create a file named .env in the root directory with the following content:

STREAM_API_KEY=<Your API key>
STREAM_USER_ID=<Your user ID>
STREAM_USER_TOKEN=<Your user token>

The easiest way to generate a token for testing purposes is to use our token generator.

Run npm install to install dependencies.

Run npm start and navigate to http://localhost:4200/.

Customization examples

This repository includes a sample app that showcases how you can provide your own template for different components within the SDK:

To run the app:

Create a file named .env in the root directory with the following content:

STREAM_API_KEY=<Your API key>
STREAM_USER_ID=<Your user ID>
STREAM_USER_TOKEN=<Your user token>

Run npm install to install dependencies.

Run npm run start:customizations-example and navigate to http://localhost:4200/.

Local development

This repository includes a sample app to test our library.

To test the app:

Create a file named .env in the root directory with the following content:

STREAM_API_KEY=<Your API key>
STREAM_USER_ID=<Your user ID>
STREAM_USER_TOKEN=<Your user token>

Run npm install in the root of the project. You can use the npm run start:dev command to start the SampleApp with automatic reloading.