Spector2

WebGPU Debugger

Development

• Install node. Note: I recommend using nvm(mac/linux) or nvm-windows(windows).

• run these commands:

  git clone https://github.com/Kangz/spector2.git
  cd spector2
  npm ci

Live development

npm start

It should open a browser to http://localhost:3000/example/. Edits to the code should end up showing up live in the browser.

Building

npm run build

This builds 3 libraries.

1. the capture library dist/capture.js

   usage:

   import { spector2 } from 'dist/capture.js
   
   ...
     const trace = await spector2.traceFrame();

2. the replay library dist/replay.js

   stand alone usage:

   TBD

   usage with capture

   TBD

3. the 'debugger' in dist/spector2.js

   usage:

   import `dist/spector2.js`;

   or

   <script src="dist/spector2.js"></script>

Pushing changes

Before you push a change please run npm run check or, better yet, make it automatic by putting

npm run check

In .git/hooks/pre-push and then set the executable bit chmod u+x .git/hooks/pre-push

We use prettier to format code so if you find errors, some of them may be able to be fixed with npm run fix.