# @tencentcloud/lite-chat

> Tencent Cloud Chat SDK for Web/Mini Program/uni-app

Latest version **4.4.5** (published 2026-09-11) · ISC license · 0 weekly downloads

## Install

```sh
npm install @tencentcloud/lite-chat
pnpm add @tencentcloud/lite-chat
yarn add @tencentcloud/lite-chat
bun add @tencentcloud/lite-chat
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

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

## Facts

| | |
|---|---|
| Version | 4.4.5 |
| Published | 2026-09-11 |
| First published | 2025-03-05 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Tencent Cloud Terminal R&D Center |
| Maintainers | alsotang, wbxl2000, xinli123, viktorli, ashfieldfox, ashster, dawnrking, bernlao, llwyct, allen0809npm, oriettazimmerfeng, kyonqi, rychouwei, rgzhao |
| Keywords | chat, real-time chat, uni-app, push, webpush, messaging, IM, trtc |

## Links

- npm: https://www.npmjs.com/package/@tencentcloud/lite-chat
- Repository: https://trtc.io/products/chat
- npm.io page: https://npm.io/package/@tencentcloud/lite-chat

## Alternatives

- [@js-joda/timezone](https://npm.io/package/@js-joda/timezone.md) — 383.4K weekly downloads
- [chartjs-adapter-moment](https://npm.io/package/chartjs-adapter-moment.md) — 210.8K weekly downloads
- [strftime](https://npm.io/package/strftime.md) — 171.2K weekly downloads
- [vue-flatpickr-component](https://npm.io/package/vue-flatpickr-component.md) — 115.8K weekly downloads
- [timepicker](https://npm.io/package/timepicker.md) — 51.0K weekly downloads

## Recent versions

- 4.4.5 (latest) — 2026-09-11
- 4.4.3-wb.4 (wb) — 2026-09-17
- 1.6.21-beta.1 (beta) — 2026-09-16
- 1.6.21 — 2026-09-17
- 4.4.6-beta.1 — 2026-09-16
- 4.4.3-wb.3 — 2026-09-11
- 1.6.20 — 2026-09-11
- 4.4.4 — 2026-09-08
- 1.6.19 — 2026-09-08
- 4.4.3-wb.2 — 2026-08-07
- 4.4.3 — 2026-08-04
- 1.6.18 — 2026-08-04
- 1.6.18-beta.1 — 2026-08-03
- 4.4.3-wb.1 — 2026-07-31
- 4.4.2 — 2026-07-17
- … 56 more at https://npm.io/package/@tencentcloud/lite-chat/versions

## README

# Official JavaScript SDK for Tencent Cloud Lite Chat

## About Tencent Cloud Lite Chat

Tencent Cloud Lite Chat provides globally interconnected chat APIs, multi-platform SDKs. Includes message sending/receiving and user management features by default, fulfilling core IM capabilities, with a bundle size under 200 KB. With its flexible plugin architecture, the SDK enables seamless integration of comprehensive IM features. You can selectively include only the features you need, customize plugin combinations, and maintain optimal bundle size.

Lite Chat SDK provides basic version, standard version and professional version. @tencentcloud/lite-chat points to the standard version by default.

## Installation

```javascript
npm install @tencentcloud/lite-chat --save
```

## Getting started

### 1. create an SDK instance

```javascript
import TencentCloudChat from '@tencentcloud/lite-chat';

// Create an SDK instance. 
// The `TencentCloudLiteChat.create()` method returns the same instance for the same `SDKAppID`.
// The SDK instance is usually represented by `chat`.
let chat = TencentCloudLiteChat.create({
  SDKAppID: 0 // Replace `0` with the `SDKAppID` of your Chat app during access.
}); 
```

### 2. Generate UserSig
UserSig is a password used to log in to Tencent Cloud Lite Chat. It is the ciphertext obtained after data such as UserID is encrypted. This [document](https://trtc.io/document/34385) describes how to generate a UserSig.

### 3. Login in to the Lite Chat SDK

```javascript
let promise = chat.login({userID: 'your userID', userSig: 'your userSig'});
promise.then(function(imResponse) {
  console.log(imResponse.data); // Login successful
  if (imResponse.data.repeatLogin === true) {
    // Indicates that the account has logged in and that the current login will be a repeated login.
    console.log(imResponse.data.errorInfo);
  }
}).catch(function(imError) {
  console.warn('login error:', imError); // Error information
});
```

## Switch to basic version

```javascript
import TencentCloudChat from '@tencentcloud/lite-chat/baisc';
```

## Switch to professional version

```javascript
import TencentCloudChat from '@tencentcloud/lite-chat/professional';
```

## Supported Browsers

|  Browser   |  Supported versions  |
|  ----  | ----  |
| Chrome | 16 or higher |
| Edge | 	13 or higher |
| Firefox | 11 or higher |
| Safari | 7 or higher |
| Internet Explorer	 | 10 or higher |
| Opera | 12.1 or higher |
| iOS Safari	| 7 or higher |
| Android Browser | 4.4 (Kitkat) or higher |

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