# signo

> Passkey sign-in that websites use instead of "Sign in with Google". An OpenID Connect provider, open source under the AGPL-3.0.

This copy of signo runs at https://usesigno.co.uk. Every page on this site is also Markdown: add .md to its path, or send Accept: text/markdown.

## Get started

- [Quickstart](https://usesigno.co.uk/docs/quickstart.md): Add signo to a site that signs people in with Google today: add the site, swap three settings, keep existing users.
- [How signo works](https://usesigno.co.uk/docs/how-it-works.md): What happens during a sign-in, how accounts and passkeys work, and what sites receive.

## Switch from Google

- [Auth.js](https://usesigno.co.uk/docs/authjs.md): Switch an Auth.js (NextAuth) app from Google to signo, and keep the people who signed up with Google.
- [Better Auth](https://usesigno.co.uk/docs/better-auth.md): Switch a Better Auth app from Google to signo with its Generic OAuth plugin.
- [Supabase](https://usesigno.co.uk/docs/supabase.md): Add signo to Supabase Auth as a custom OpenID Connect provider.
- [Any OpenID Connect library](https://usesigno.co.uk/docs/openid-connect.md): Use signo from any OpenID Connect library: discovery, settings and an openid-client example.
- [Single-page app (signo.js)](https://usesigno.co.uk/docs/single-page-apps.md): Sign people in to a single-page app with no server and no client secret, using signo.js and PKCE.

## For agents

- [Agent access](https://usesigno.co.uk/docs/agents.md): (planned) The plan for agents that act for people, and the rules agents should follow today.
- [llms.txt and Markdown](https://usesigno.co.uk/docs/markdown.md): Get any page as Markdown, and the llms.txt index of the docs.

## Reference

- [Endpoints](https://usesigno.co.uk/docs/endpoints.md): Every endpoint signo serves, for apps, people and agents, and the rate limits.
- [Scopes and claims](https://usesigno.co.uk/docs/scopes-and-claims.md): The scopes sites can ask for, and the claims signo returns for each.
- [Tokens and lifetimes](https://usesigno.co.uk/docs/tokens.md): How long codes, tokens, sessions and consent last, how ID tokens are signed, and what signing out does.
- [Security model](https://usesigno.co.uk/docs/security.md): Everything signo stores, its cookies, protocol settings and rate limits, and what deleting an account removes.
- [Self-hosting](https://usesigno.co.uk/docs/self-hosting.md): Run your own signo with Docker: setup, settings, hosting notes and backups.

## About this copy

- [Home](https://usesigno.co.uk/index.md): what signo is, for people, developers and agents
- [Trust and security](https://usesigno.co.uk/trust.md): standards, what is stored and for how long, where this copy runs
- [Privacy](https://usesigno.co.uk/privacy.md): what this copy stores about people and who receives it

## Optional

- [All the docs in one file](https://usesigno.co.uk/llms-full.txt)