Skip to content

docs: add a Start here section with the ecosystem diagram - #367

Merged
Bccorb merged 1 commit into
mainfrom
docs/readme-start-here
Oct 7, 2026
Merged

Bccorb merged 1 commit into
mainfrom
docs/readme-start-here

Conversation

@Bccorb

@Bccorb Bccorb commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

Summary

Part of fells-code/seamless-auth-docs#45 (one front door across the ecosystem). Adds a Start here section after the description, and as the first Contents entry:

  • links to the self-hosted quickstart (Docker) first, then the managed quickstart
  • the shared ecosystem topology diagram (Mermaid), with the seamless-auth-api node highlighted: it owns sessions and issues the tokens your backend verifies
  • links to "How the pieces connect" and the compatibility matrix

The repo's own local and Docker quickstarts are kept, since they cover developing this repo. README only, no changeset.

Testing

npm run format:check, npm run lint, npm run typecheck, and npm run test:run (1748 passed) pass. The diagram parses and renders with Mermaid 11.

Refs fells-code/seamless-auth-docs#45

Point new readers at the docs quickstarts (Docker self-hosted first,
managed second) before the repo-specific setup, show where the auth API
sits in the ecosystem with a Mermaid topology diagram that highlights
this repo, and link the compatibility matrix. The block is shared
across the public Seamless Auth repos so the front door reads the same
everywhere.

Refs fells-code/seamless-auth-docs#45
@Bccorb
Bccorb merged commit 3d058a2 into main Oct 7, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant