A web interface for Twilio's awesome Programmable Fax API. Cooked up as a self-care project of sorts, and also because I needed to fax something.
Set up your Twilio Account SID, Twilio API key, and desired external API key as environment variables:
export TWLO_SID='Axxxxxxxxxxxxxxxxxxxx'
export TWLO_KEY='Axxxxxxxxxxxxxxxxxxxx'
export API_KEY='some-gibberish-probably-a-uuid-or-something'
I recommend using direnv
to expose env vars in a .envrc
file in the root (./
) of this project. I created a sample .envrc
file at ./envrc.sample
– just rename it to .envrc
and edit the values and you should be off to the races!
In the ./api/
directory, you'll find an Apollo Server project. Run yarn dev
to launch the server on port 4000.
In the ./web/
directory, you'll find a Next.js project. Run yarn dev
to launch the server on port 3000.
Pick a solid-ish API key, and consider using a real authentication method (like, something with tokens that expire) rather than the simple thing I cooked up. You shouldn't expose or deploy this service outside of your local machine without significant, sweeping changes.