![](\"https://www.rrweb.io/favicon.png\")
\n\n \n
\n Try rrweb\n
\n\n# rrweb\n\n**This is a simpler version of the [original rrweb README](../../README.md) within this rrweb subpackage**\n\n[δΈζζζ‘£](../../README.zh_CN.md)\n\nrrweb refers to 'record and replay the web', which is a tool for recording and replaying users' interactions on the web.\n\n## Guide\n\n[**π Read the rrweb guide here. π**](../../guide.md)\n\n[**π³ Recipes π³**](../../docs/recipes/index.md)\n\n## Project Structure\n\n**[rrweb](https://github.com/rrweb-io/rrweb)** mainly includes two funtions:\n\n- **Record**: The record function is used to record all the mutations in the DOM\n- **Replay**: The replay function is to replay the recorded mutations one by one according to the corresponding timestamp.\n\n## Roadmap\n\n- storage engine: do deduplication on a large number of rrweb sessions\n- compact mutation data in common patterns\n- provide plugins via the new plugin API, including:\n - XHR plugin\n - fetch plugin\n - GraphQL plugin\n - ...\n\n## Internal Design\n\n- [serialization](../../docs/serialization.md)\n- [incremental snapshot](../../docs/observer.md)\n- [replay](../../docs/replay.md)\n- [sandbox](../../docs/sandbox.md)\n\n## Contribute Guide\n\nSince we want the record and replay sides to share a strongly typed data structure, rrweb is developed with typescript which provides stronger type support.\n\n[Typescript handbook](https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html)\n\n1. Fork this repository.\n2. Run `yarn install` in the root to install required dependencies for all sub-packages (note: `npm install` is _not_ recommended).\n3. Run `yarn dev` in the root to get auto-building for all the sub-packages whenever you modify anything.\n4. Navigate to one of the sub-packages (in the `packages` folder) where you'd like to make a change.\n5. Patch the code and run `yarn test` to run the tests, make sure they pass before you commit anything.\n6. Push the code and create a pull request.\n\nProtip: You can run `yarn test` in the root folder to run all the tests.\n\nIn addition to adding integration tests and unit tests, rrweb also provides a REPL testing tool.\n\n[Using the REPL tool](../../guide.md#REPL-tool)","users":{}}