@adrianhall/cloudflare-toolkit

A toolkit of utilities and skills for developing Workers on the Cloudflare Dev Platform. @adrianhall/cloudflare-toolkit replaces the boilerplate historically scattered across multiple GitHub-only libraries — defensive guards, HTTP error generators, RFC 9457 problem details, structured logging, Cloudflare Access-aware Hono/Vite middleware, typed Access configuration, and deployment CLIs — with a single, MIT-licensed, npm-installable package.

Full documentation, guides, and API reference:

https://adrianhall.github.io/cloudflare-toolkit

Install

npm install @adrianhall/cloudflare-toolkit

Quickstart

The hono subpath exports four independent middleware for a Cloudflare Access-protected Hono app: structured logging, Access enforcement, and problem-details-based error handling. Each is wired independently:

import {
  cloudflareAccess,
  cloudflareLogger,
  problemDetailsErrorHandler,
  notFoundHandler
} from "@adrianhall/cloudflare-toolkit/hono";
import { Hono } from "hono";

const app = new Hono();

app.use(cloudflareLogger({/* ... */}));
app.use(cloudflareAccess({/* ... */}));

app.onError(problemDetailsErrorHandler());
app.notFound(notFoundHandler());

export default app;

See the documentation site for guides covering every export, including the defensive guards, HTTP error generators, the standalone logging core, the Vite plugin, the root defineAccessConfig helper, and the cf-access-policy, generate-wrangler, generate-wrangler-types, destroy-containers, and empty-r2-bucket CLIs.

AI Skill

Installable Agent Skills teach coding agents how to use the library and its Terraform/Wrangler deployment workflow:

npx skills add adrianhall/cloudflare-toolkit

Contributing

See CONTRIBUTING.md for the PR and release-preparation process, RELEASING.md for how releases are cut, and AGENTS.md for engineering conventions.

License

MIT