SimplerAuth

From Jan Wilmake's personal knowledge base

SimplerAuth

SimplerAuth (simplerauth.com) is a collection of minimal, copy-pasteable OAuth authentication libraries for Cloudflare Workers, developed by Jan Wilmake. The project reflects Jan's philosophy that most auth frameworks are over-engineered and that a simple 200-line file is often all you need.

Philosophy

Jan bought the domain in June 2025 with a clear rationale:[1]

"Most auth frameworks are just making things more bloated. We need something simpler."

The core insight: auth libraries create huge dependencies and abstract away auth completely. SimplerAuth takes the opposite approach — each provider is a single, highly readable, copy-pasteable file of approximately 200 lines, with no external dependencies. "There's not even a need for it to become a dependency really — it's just one copy-pasteable file."[1]

SimplerAuth is explicitly Cloudflare Workers-only: "Oh and it'll just work for cloudflare because that's what I'm using. I have no intention of making it work elsewhere. Be my guest!"[1]

Providers and Libraries

The project is organised as a GitHub Stars list (github.com/stars/janwilmake/lists/simpler-auth) containing individual provider implementations:[1]

  • GitHub OAuthgithub.com/janwilmake/github-oauth-client-provider; includes withSimplerAuth middleware that enforces authenticated user for the entire handler
  • X (Twitter) OAuthx.simplerauth.com (github.com/janwilmake/x-oauth-middleware)

The withSimplerAuth pattern composes with other Cloudflare Workers middleware in a clean wrapper style:

withPathKv(withSimplerAuth(withStripeflare(handler)))

A provider for the entire auth flow was published as simplerauth-provider in August 2025, with an associated blog post at github.com/janwilmake/simplerauth-provider/blob/main/BLOG.md.[2]

Integration with Jan's Stack

SimplerAuth became the auth layer for multiple Jan projects. In June 2025 he described his target uithub architecture as:

withMcp(withPathKv(withSimplerAuth(uithubHandler)))

This pattern appeared across uithub, ContextArea, and other Cloudflare Workers-based tools. The approach prioritised minimalism and kept the codebase easy to audit.

December 2025: Single-Repo Consolidation

On December 24, 2025, Jan consolidated all SimplerAuth templates into a single repository at github.com/janwilmake/simplerauth. Previously the project was distributed across a GitHub Stars list, which slowed adoption. Jan credited Sam Goodwin with suggesting the consolidation.[3] The project had under 100 stars total across the distributed repos; the consolidation was intended to make discovery and adoption easier.

Jan re-introduced it with: "SimplerAuth is an unconventional way to do auth by owning the code yourself and actually learning how it works. Where most auth libraries abstract away auth completely, SimplerAuth is a single, highly readable, copy-pasteable file of ~200 lines."[3]

February 2026: SMS OAuth Provider

In February 2026, Jan added a Twilio SMS OAuth provider to the repo — a minimal example showing how to set up SMS-based login for an MCP server. This extended SimplerAuth's scope beyond social OAuth into phone-number-based authentication, relevant for agent and MCP server use cases.[4]

See Also

References

  1. X post archive: x-archive/raw/posts/2025-06-03.md 
  2. X post archive: x-archive/raw/posts/2025-08-19.md 
  3. X post archive: x-archive/raw/posts/2025-12-24.md 
  4. X post archive: x-archive/raw/posts/2026-02-04.md