Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/replayio/devtools
Replay.io DevTools
https://github.com/replayio/devtools
Last synced: 8 days ago
JSON representation
Replay.io DevTools
- Host: GitHub
- URL: https://github.com/replayio/devtools
- Owner: replayio
- License: other
- Created: 2020-05-04T15:09:06.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T17:55:34.000Z (7 months ago)
- Last Synced: 2024-04-14T11:50:53.312Z (7 months ago)
- Language: TypeScript
- Homepage: https://replay.io
- Size: 165 MB
- Stars: 650
- Watchers: 8
- Forks: 135
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
README
# Replay
Replay is a new debugger for recording and replaying software. Debugging with Replay should be as simple as viewing print statements and more powerful than pausing with breakpoints. Of course, debugging should be collaborative as well!
## Issues
Feel free to file any issues you see while recording or replaying.
## Getting started
Replay's DevTools is a React app built on top of the Replay [protocol](https://www.notion.so/replayio/Protocol-d8e7b5f428594589ab60c42afad782c1). Make sure to install [nvm](https://github.com/nvm-sh/nvm#installing-and-updating).
> **Note**: We use Yarn 3 for package management - make sure you have Yarn installed globally first:
> `npm i -g yarn`
Getting started is as simple as:
```sh
# Setup environment variables
cp .env.sample .env
# Install dependencies
nvm use
yarn install
# Run dev server (see below)
```
### Developing against production
To run DevTools locally, paired with the production [Dashboard](https://github.com/replayio/dashboard) project:
```sh
yarn dev:prod
```
At this point DevTools will be accessible at [localhost:8080](http://localhost:8080/) and will proxy any library or authentication requests to the production deployment of the [Dashboard](https://github.com/replayio/dashboard) project.
### Local development
To run both the DevTools and [Dashboard](https://github.com/replayio/dashboard) projects locally:
```sh
# DevTools (this project)
yarn dev:local
# Dashboard
pnpm dev:local
```
At this point the Dashboard will be accessible at [localhost:8080](http://localhost:8080/) but it will not load recordings. To be able to test the end-to-end interaction of both apps, use [localhost:8081](http://localhost:8081/). It will serve both Dashboard and DevTools routes.
### Next steps
Next, download and install the [Replay browser](https://www.replay.io/). The browser will allow you to start recording your own replays.
### Community
Everybody's welcome to join us [on Discord](https://replay.io/discord/), but please read through our [Community Etiquette](https://docs.replay.io/contribute/contributing-to-replay) guidelines first.
### Contributing to the project
Anyone is welcome to contribute to the project! If you're just getting started we recommend you start by reading the [contributing guide](https://github.com/replayio/devtools/blob/main/docs/contributing.md) and then check out the ["good first issues"](https://github.com/RecordReplay/devtools/issues?q=is%3Aissue+is%3Aopen+label%3A%22Good+first+issue%22). If you have questions you can ask in the in the [#development](https://discord.com/channels/779097926135054346/795692423513767956) channel. (Please do not "@" or direct message people with questions though!)
### Running tests:
To run the end-to-end tests make sure that devtools is running locally on port 8080 and run:
```
cd packages/e2e-tests
yarn test
```
#### Running tests against local builds of the browser
If you want to run the tests against a local build of the browser, you'll need to invoke the tests like so:
```
RECORD_REPLAY_PATH=~/devel/gecko-dev/rr-opt/dist/Replay.app RECORD_REPLAY_BUILD_PATH=~/devel/gecko-dev node test/run.js
```
Replace the paths with the appropriate paths to and within `gecko-dev` as appropriate in your environment.
#### Running tests against local builds of the backend
If you want to run the tests against a local build of the backend, you'll need to invoke the tests like so:
```
RECORD_REPLAY_SERVER=ws://localhost:8000 RECORD_REPLAY_DRIVER=~/devel/backend/out/macOS-recordreplay.so node test/run.js
```
Replace the paths with the appropriate paths within the `backend` repo as appropriate in your environment.
#### Installing the trunk launcher
This project uses [trunk](https://trunk.io) to lint and format its code. Trunk is installed as a dev dependency so you can invoke it as `npx trunk`.
To learn more about `trunk`, check out the [documentation](https://docs.trunk.io).
#### Linting your changes
In most cases you can simply run `trunk check` which will autodetect the changes you have made and lint them.
If you would like to only autoformat your changes, you can run `trunk fmt`.
More information on using trunk can be found [here](https://docs.trunk.io/getting-started/usage).
#### Generating GraphQL types for Typescript
See [/src/graphql/README.md](./src/graphql/README.md) for details.
### Deploying
Every commit to the main branch is automatically deployed to production.