I built a better documentation site for oidc-provider

Justin Dah-kenangnon — Mon, 06 Apr 2026 11:04:45 +0000

While building a production-ready OpenID Connect server with oidc-provider, I ran into a recurring issue:

👉 the documentation is powerful, but not easy to navigate.

So I built this:

The problem

oidc-provider has excellent documentation, but it is:

This makes onboarding and day-to-day usage slower than it should be.

I created a dedicated documentation site that is:

The key design constraint was:

never diverge from the official documentation

So the site is:

automatically generated from official sources:
- README
- docs/*
- CHANGELOG
- events.md
continuously synced via GitHub Actions

Any update in the upstream repository is reflected automatically.

oidc-provider is a low-level, spec-compliant implementation.

That means:

This site aims to improve:

Planned additions:

If you are using oidc-provider, feedback is highly valuable.

The goal is to make the ecosystem easier to approach without altering its philosophy.