Repository navigation
docs(compare): add Seamless Auth vs Keycloak page - #126
Merged
Merged
Conversation
Compares footprint, setup, theming, upgrades, passkeys, protocols, organizations and SCIM, with a "Choose Keycloak If" section first. Every Keycloak fact links to a keycloak.org page or the keycloak/keycloak repository, with the date it was checked. Seamless footprint figures are measured, and the method is stated on the page. Closes #108
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #108
Adds
src/content/docs/compare/keycloak.mdx(sidebar order 5; the Auth0 page in progress ondocs/compare-auth0takes 4).Draft pending the maintainer's sign-off, and a re-check of every source below on the publish day. Keycloak ships often (26.8.0 on 2026-10-01, 26.8.1 on 2026-10-13), so version-dependent statements (SCIM, passkeys, rolling updates) need re-checking.
What the page covers
Footprint, setup, theming, upgrades, passkeys, protocols, organizations, SCIM, architecture and migration. "Choose Keycloak If" comes first: SAML, LDAP/AD/Kerberos federation, a standards-based OIDC provider, SCIM, passwords and realms, maturity and SPI extensibility.
Note for review: the issue assumed Keycloak has no native SCIM. Keycloak's own docs say otherwise: the SCIM API was preview in 26.7.0 and is a supported, default-enabled feature since 26.8.0 (enabled per realm). The page says so, and lists SCIM under "Choose Keycloak If".
Dropped for lack of a Keycloak-owned source: "flow changes apply instantly" and general JVM-footprint complaints. The theme point is stated only as Keycloak's own guides put it (overridden templates may need updating on upgrade; the upgrading guide has a theme migration step).
Keycloak sources (all checked 2026-10-20)
How the Seamless footprint figures were measured (2026-10-20)
ghcr.io/fells-code/seamless-auth-api:v0.19.1. Compressed size is the sum of layer sizes indocker manifest inspectfor each platform manifest: about 120 MB for both linux/amd64 and linux/arm64. Uncompressed:docker image inspecton the pulled linux/arm64 image, 687,384,909 bytes.docker-compose.ymlwithSEAMLESS_AUTH_IMAGEpinned to v0.19.1 (development mode, empty database, no traffic),docker stats --no-streamon Docker Desktop for macOS arm64. About 138 MiB right after start, about 73 MiB idle three minutes later; Postgres about 36 MiB.No Keycloak memory or image figure was measured; the page only uses Keycloak's published guidance.
Checks
npx prettier --check .: All matched files use Prettier code stylenpm run lint: exit 0 (eslint, no-H1 check, SDK results check)npm run typecheck: 0 errors, 0 warnings, 0 hintsnpm run build: 54 pages built,/compare/keycloak/included; internal links and anchors on the page checked againstdist/