# @trezor/connect-web

> High-level javascript interface for Trezor hardware wallet in web environment.

Latest version **10.0.1** (published 2026-09-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @trezor/connect-web
pnpm add @trezor/connect-web
yarn add @trezor/connect-web
bun add @trezor/connect-web
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 10.0.1 |
| Published | 2026-09-25 |
| First published | 2022-06-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 44 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1064 |
| Author | Trezor <info@trezor.io> |
| Maintainers | prusnak, tsusanka-sl, trezor-ci, trezor-admin |
| Keywords | Trezor, trezor-connect, javascript |

## Links

- npm: https://www.npmjs.com/package/@trezor/connect-web
- Repository: https://github.com/trezor/trezor-suite
- Homepage: https://github.com/trezor/trezor-suite/tree/develop/packages/connect-web
- Issues: https://github.com/trezor/trezor-suite/issues
- npm.io page: https://npm.io/package/@trezor/connect-web

## Dependencies (3)

- [@trezor/utils](https://npm.io/package/@trezor/utils.md) 10.0.1
- [@trezor/connect-common](https://npm.io/package/@trezor/connect-common.md) 10.0.1
- [@trezor/websocket-client](https://npm.io/package/@trezor/websocket-client.md) 10.0.1

## Recent versions

- 10.0.1 (latest) — 2026-09-25
- 10.0.0-beta.3 (beta) — 2026-09-17
- 10.0.0-alpha.1 (alpha) — 2026-05-20
- 10.0.0 — 2026-09-22
- 10.0.0-beta.2 — 2026-09-16
- 10.0.0-beta.1 — 2026-07-30
- 9.7.3 — 2026-04-22
- 9.7.2 — 2026-02-26
- 9.7.2-beta.1 — 2026-02-25
- 9.7.1 — 2025-12-22
- 9.7.1-beta.2 — 2025-12-19
- 9.7.1-beta.1 — 2025-12-19
- 9.7.0 — 2025-12-16
- 9.7.0-beta.2 — 2025-12-09
- 9.7.0-beta.1 — 2025-11-25
- … 92 more at https://npm.io/package/@trezor/connect-web/versions

## README

# @trezor/connect-web

[![NPM](https://img.shields.io/npm/v/@trezor/connect-web.svg)](https://www.npmjs.org/package/@trezor/connect-web)

This package is bundled into web implementations. There are two primary runtime modes:

- **Suite Desktop WebSocket**: when Trezor Suite Desktop is running, Connect talks to it over a localhost WebSocket and UI is handled inside Suite.
- **Suite Web popup**: otherwise, user interaction is presented in a secure popup window served from `https://suite.trezor.io/web/connect-popup/`.

To try it out, use [@trezor/connect-explorer](https://github.com/trezor/trezor-suite/tree/develop/packages/connect-explorer) hosted [here](https://connect.trezor.io/10/).

Contains minimum of code required to:

- Define `TrezorConnect` API object
- Create and handle communication and lifecycle of Connect popup window

## Installation

Install library as npm module:

```javascript
npm install @trezor/connect-web
```

or

```javascript
yarn add @trezor/connect-web
```

## Initialization

ES6

```javascript
import TrezorConnect from '@trezor/connect-web';
```

For more instructions [refer to this document](https://github.com/trezor/trezor-suite/blob/develop/docs/packages/connect/index.md)

## Development

- clone repository: `git clone git@github.com:trezor/trezor-suite.git`
- install node_modules: `yarn && yarn build:libs`

## TrezorConnect Support Matrix

The table below details the support for different environments by TrezorConnect for integrating Trezor devices, including the use of WebUSB and the need for Trezor Bridge.

| Environment                   | Chrome | Firefox | Safari | Chrome Android | Firefox Android | Notes                                                                   |
| ----------------------------- | :----: | :-----: | :----: | :------------: | :-------------: | ----------------------------------------------------------------------- |
| Web (WebUSB)                  |   ✓    |    ✗    |   ✗    |       ✓        |        ✗        | WebUSB is fully supported where indicated. (Chromium based browsers)    |
| Web (Bridge)                  |   ✓    |    ✓    |   ✗    |       ✗        |        ✗        | Trezor Bridge is required where WebUSB is not supported. (e.g. Firefox) |
| WebExtension (WebUSB, Bridge) |   ✓    |    ✓    |   ✗    |       ✓        |        ✗        | Requires Trezor Bridge on platforms not supporting WebUSB.              |

## Key Differences

- **WebUSB**: Allows direct communication with Trezor devices via the browser. Supported by most modern browsers but may have limitations on mobile devices and is not supported by Safari.
- **Trezor Bridge**: A service that runs with Trezor Suite or Standalone that facilitates communication between your Trezor device and a web browser. Required for browsers that do not support WebUSB or for a more stable connection on desktop environments.

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