DEV Community

Amy Kapernick
Amy Kapernick

Posted on

GitHub PR Reviews via Fax

What I built

An integration that allows reviewing and commenting on a GitHub Pull Request via Fax

Category Submission:

COVID-19 Communications, Interesting Integrations, Exciting X-Factors

Demo Link

Link to Code

GitHub Fax PR Reviews

And integration to allow reviewing and commenting on pull requests via fax.



To Use

  • Download repository
  • Run npm install or yarn install
  • Run cp .env.example .env to create new .env file
  • Fill in env variables in .env file from your Twilio account
  • Use npm start to run locally
  • Use ngrok to expose the page
  • In your Twilio Console, edit the fax capable number you're using to send
    • Change it to Accept Incoming Faxes (will likely be Voice Calls by default)

How I built it (what's the stack? did I run into issues or discover something new along the way?)

Built on Express using Node JS, using the Twilio Fax API, Microsoft's Cognitive Services Computer Vision API and GitHub's API

When a pull request is opened on GitHub, it triggers a webhook to fire. That webhook generates a PDF with information about the PR and sends it via fax.

Comments can be written on the fax, and faxed back, which when received, sends the fax PDF to Microsoft's Cognitive Services Computer Vision to read the text in the PDF. Using the information taken from the fax, a comment is added to the pull request on GitHub.

Additional Resources/Info

Built on Twitch stream over a few different sessions

Live Demo also available on request (not hosted, running locally on my computer, but can be set up to demo)

Top comments (0)