diff --git a/.craft.yml b/.craft.yml index 053da2ef4a..b08ac53b0f 100644 --- a/.craft.yml +++ b/.craft.yml @@ -13,3 +13,4 @@ targets: includeNames: /^sentry-.*.tgz$/ - name: npm includeNames: /^sentry-.*.tgz$/ + diff --git a/README.md b/README.md index e0289196d3..6725c15bee 100644 --- a/README.md +++ b/README.md @@ -1,282 +1,3 @@ -
-
-
-
-
-
-
- Check out the original rrweb Repo -
-- rrweb.io -
- -# rrweb - -**[The rrweb documentary (in Chinese, with English subtitles)](https://www.bilibili.com/video/BV1wL4y1B7wN?share_source=copy_web)** - -[](https://join.slack.com/t/rrweb/shared_invite/zt-siwoc6hx-uWay3s2wyG8t5GpZVb8rWg) -[](https://twitter.com/rrweb_io) - - -[](https://www.jsdelivr.com/package/npm/rrweb) - -[δΈζζζ‘£](./README.zh_CN.md) - -> I have joined Github Sponsors and highly appreciate your sponsorship. - -rrweb refers to 'record and replay the web', which is a tool for recording and replaying users' interactions on the web. - -## Guide - -[**π Read the rrweb guide here. π**](./guide.md) - -[**π³ Recipes π³**](./docs/recipes/index.md) - -[**πΊ Presentation:** Hacking the browser to digital twin your users πΊ](https://youtu.be/cWxpp9HwLYw) - -## Project Structure - -rrweb is mainly composed of 3 parts: - -- **[rrweb-snapshot](https://github.com/rrweb-io/rrweb/tree/master/packages/rrweb-snapshot/)**, including both snapshot and rebuilding features. The snapshot is used to convert the DOM and its state into a serializable data structure with a unique identifier; the rebuilding feature is to rebuild the snapshot into corresponding DOM. -- **[rrweb](https://github.com/rrweb-io/rrweb)**, including two functions, record and replay. The record function is used to record all the mutations in the DOM; the replay is to replay the recorded mutations one by one according to the corresponding timestamp. -- **[rrweb-player](https://github.com/rrweb-io/rrweb/tree/master/packages/rrweb-player/)**, is a player UI for rrweb, providing GUI-based functions like pause, fast-forward, drag and drop to play at any time. - -## Roadmap - -- storage engine: do deduplication on a large number of rrweb sessions -- compact mutation data in common patterns -- provide plugins via the new plugin API, including: - - XHR plugin - - fetch plugin - - GraphQL plugin - - ... - -## Internal Design - -- [serialization](./docs/serialization.md) -- [incremental snapshot](./docs/observer.md) -- [replay](./docs/replay.md) -- [sandbox](./docs/sandbox.md) - -## Contribute Guide - -Since we want the record and replay sides to share a strongly typed data structure, rrweb is developed with typescript which provides stronger type support. - -[Typescript handbook](https://www.typescriptlang.org/docs/handbook/declaration-files/introduction.html) - -1. Fork this repository. -2. Run `yarn install` in the root to install required dependencies for all sub-packages (note: `npm install` is _not_ recommended). -3. Run `yarn dev` in the root to get auto-building for all the sub-packages whenever you modify anything. -4. Navigate to one of the sub-packages (in the `packages` folder) where you'd like to make a change. -5. Patch the code and run `yarn test` to run the tests, make sure they pass before you commit anything. Add test cases in order to avoid future regression. -6. If tests are failing, but the change in output is desirable, run `yarn test:update` and carefully commit the changes in test output. -7. Push the code and create a pull request. - -Protip: You can run `yarn test` in the root folder to run all the tests. - -In addition to adding integration tests and unit tests, rrweb also provides a REPL testing tool. - -[Using the REPL tool](./guide.md#REPL-tool) - -## Sponsors - -[Become a sponsor](https://opencollective.com/rrweb#sponsor) and get your logo on our README on Github with a link to your site. - -### Gold Sponsors π₯ - - - -### Silver Sponsors π₯ - - - -### Bronze Sponsors π₯ - - - -### Backers - -|
-
- Yuyz0112 - - - |
-
-
- Yun Feng - - - |
-
-
- eoghanmurray - - - |
-
-
- Juice10 - open for rrweb consulting - - |
-
-
-
-
- |
-
-
-
-
- |
-
-
- |
-
-
- |
-
|
-
- |
-
-
-
-
- |
-
-
-
-
- |
-
-
-
-
- |
-
|
-
- |
-
-
- |
-
-
-
-
- |
-
-
- |
-