• Production @ https://graypaper.fluffylabs.dev
• Beta @ https://graypaper-reader.netlify.app

A tool to help with reading and analyzing the Gray Paper.

• Gray Paper Reader community notes graypaper-notes.
• Gray Paper Archive graypaper-archive.

• matrix-bot - Listens to Matrix channel messages and collects the ones containing GP Reader links. These messages can later be turned into notes JSON file.
• links-check - Scan a set of files for GP Reader links and check their versions or generate notes JSON file.

Gray Paper versions are stored in a separate repository, added as a git submodule.

$ git submodule update --init 

$ npm ci      # install dependencies
$ npm run dev # run the development version

Visual snapshot tests checks for visual regression.

For consistent snapshots that match GitHub Actions:

# Build Docker images
npm run docker:build

# Run tests
npm run docker:test
# Then open tools/snapshot-test/playwright-report/index.html for visual regression report

# Update snapshots
npm run docker:test:update

This will update all the snapshots. You can compare it afterward in your local Git GUI or Github web interface, and take actions if something is wrong.

To run all visual snapshots tests locally:

cd tools/snapshot-tests
npm install
npm run test 

One can also run tests with UI simply via:

npm start

Note: Local testing may produce different snapshots than CI due to environment differences. Use Docker-based testing for consistent results.