This is the repository that builds the static documentation website for docs.iron.security using hugo for generating the HTML/CSS/JS and then wrangler to deploy everything to Cloudflare Workers all over the globe.
Workers was chosen instead of Cloudflare Pages so we can set HTTP security headers on HTTP responses and even handle contact form submissions to Mailgun. Workers uses Cloudflare KV under the hood to store all static assets and retrieve them according to a caching policy.
For local development miniflare is used to not have to store the worker in Cloudflare KV every time we run it during development, triggering additional quotas.
If you just want to edit the website, a make dev-hugo will kickstart hugo on localhost:1313.
For a more complete local environment with the worker (and e.g. security headers set) plus hugo, wrangler-cli and miniflare installed, you can just run make for local development.
% # this installs npm and hugo via brew
% make install