From 2ad0b46edf177b755f21bb752d2cca223b4154f5 Mon Sep 17 00:00:00 2001 From: ardetrick <1452182+ardetrick@users.noreply.github.com> Date: Sun, 26 Jul 2026 07:43:03 -0500 Subject: [PATCH] docs(reference-app): collapse the walkthrough behind a disclosure MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Shows the consent screen as a single hero image, then tucks the full four-step sequence behind a
so the reader can click through it without the section dominating the README. Uses the existing stills — no gif or video. --- README.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 1b9c0db..95480a2 100644 --- a/README.md +++ b/README.md @@ -244,26 +244,33 @@ jwk [like this](https://jwt.io/#debugger-io?token=eyJhbGciOiJSUzI1NiIsImtpZCI6Im ## See it work -A walk through the authorization code flow with OpenID Connect, from login to real -tokens. Run `./gradlew bootTestRun` and open http://localhost:8080 to click through it -yourself. +Log in, authorize the requested scopes, and the app exchanges the authorization code for +real tokens from Hydra. Run `./gradlew bootTestRun` and open http://localhost:8080 to +click through it yourself. -Log in (the demo credentials are pre-filled): +![consent screen](docs/images/authorization-code-flow/2-consent.png) + +
+See the full flow, step by step + +Log in — the demo credentials are pre-filled. ![login screen](docs/images/authorization-code-flow/1-login.png) -Authorize the scopes the application is requesting: +Authorize the scopes the application is requesting. ![consent screen](docs/images/authorization-code-flow/2-consent.png) -Hydra redirects back with an authorization code, which the app exchanges for tokens: +Hydra redirects back with an authorization code, which the app exchanges for tokens. ![callback screen](docs/images/authorization-code-flow/3-callback-page.png) -The result is a real access token, ID token, and refresh token from Hydra: +The result is a real access token, ID token, and refresh token from Hydra. ![token response](docs/images/authorization-code-flow/4-tokens.png) +
+ ## Building against a different testcontainers-ory-hydra version The `testcontainersOryHydraVersion` Gradle property overrides the version pinned in