Files

Justin Halsall bcf93ca926 docs: revamp installation docs for esm and umd (#1788 )

* docs: revamp installation docs for esm and umd

Document recommended install paths across the main guides and package
READMEs for rrweb, @rrweb/all, @rrweb/record, @rrweb/replay, and
rrweb-player.

Clarify three usage modes: bundler/npm, browser no-build with
import maps and +esm, and legacy UMD fallback.

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Apply formatting changes

* Apply suggestion from @eoghanmurray

Co-authored-by: Eoghan Murray <eoghan@getthere.ie>

* Apply formatting changes

* docs(all): streamline README usage section

Move the guide link next to the import example and remove the
duplicated Usage section to keep docs concise and easier to scan.

* docs(readme): update gzip size badges in zh-cn readme

* docs(plugins): update readme imports to scoped esm packages

Replace `rrweb` default imports and `rrweb.Replayer` usage with
`@rrweb/record` `record` and `@rrweb/replay` `Replayer` in plugin
usage examples.

Also update canvas WebRTC plugin imports to scoped `@rrweb/*`
package names to keep docs aligned with current package structure.

* docs: update docs to prefer scoped esm packages

replace `rrweb` default import examples with `@rrweb/record` and
`@rrweb/replay` across recipes and guides in en/zh-CN.

clarify package selection for new integrations, add `@rrweb/all`
convenience guidance, and refresh CDN/style import snippets for ESM and legacy UMD compatibility.

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Eoghan Murray <eoghan@getthere.ie>

2026-02-17 13:59:02 +01:00

src

Improve development tooling (#1516 )

2024-06-21 18:13:53 +01:00

test

Chore: Migrate build to vite (#1033 )

2024-06-07 11:07:36 +02:00

.gitignore

Chore: Migrate build to vite (#1033 )

2024-06-07 11:07:36 +02:00

CHANGELOG.md

Version Packages (alpha) (#1780 )

2026-02-03 14:20:05 +01:00

package.json

Umd folder (#1704 )

2026-02-13 15:03:23 +01:00

README.md

docs: revamp installation docs for esm and umd (#1788 )

2026-02-17 13:59:02 +01:00

tsconfig.json

Chore: Migrate build to vite (#1033 )

2024-06-07 11:07:36 +02:00

vite.config.ts

Migrates to vite@6 to drop base64 inlined worker source from all bundles (#1762 )

2026-02-06 15:11:36 +01:00

vitest.config.ts

Chore: Migrate build to vite (#1033 )

2024-06-07 11:07:36 +02:00

README.md

@rrweb/replay

This package contains all the necessary code to replay recorded events. See the guide for more info on rrweb.

Installation

1) Bundler / npm (Recommended)

npm install @rrweb/replay

import { Replayer } from '@rrweb/replay';
import '@rrweb/replay/dist/style.css';

2) Browser Without Bundler (ESM + import maps)

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@rrweb/replay@latest/dist/style.css"
/>
<script type="importmap">
  {
    "imports": {
      "@rrweb/replay": "https://cdn.jsdelivr.net/npm/@rrweb/replay@latest/+esm"
    }
  }
</script>
<script type="module">
  import { Replayer } from '@rrweb/replay';
</script>

3) Legacy Direct `<script>` Include (UMD fallback)

Use this only for compatibility with non-module environments.

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@rrweb/replay@latest/dist/style.css"
/>
<script src="https://cdn.jsdelivr.net/npm/@rrweb/replay@latest/umd/replay.min.js"></script>

The legacy UMD global is rrwebReplay.

Usage

import { Replayer } from '@rrweb/replay';
import '@rrweb/replay/dist/style.css';

const replayer = new Replayer(events, {
  // options
});
replayer.play();

Notes

Currently this package is really just a wrapper around the Replayer class in the main rrweb package. All Replayer related code will get moved here in the future.