A quickstart takes you from an empty project to a working sign-in in about five minutes. You create an environment, grab its public key, install the SDK for your stack, and drop in a hosted flow or a set of components. Authdog handles the credentials, you validate the session it issues.
What a quickstart gives you
Every Authdog integration is built on the same session model. A user signs in against your environment, and Authdog issues a session: a signed JWT delivered as the authdog-session cookie (also usable as an Authorization: Bearer <token> header). Your app never touches raw credentials; it only validates the issued session against the identity provider's userinfo endpoint using your environment's public key (pk_...).
The three primitives
No matter the framework, an integration is just three pieces:
- A session resolver: reads the
authdog-sessioncookie (or Bearer token), verifies it, and exposes the current user to your code. - A protected-route gate: the server-side enforcement point that rejects unauthenticated requests with a
401and lets authenticated ones through. - A sign-out handler: clears the session cookie and redirects back to your app.
Frontend SDKs wrap these in hooks and route guards; backend SDKs wrap them in middleware. Learn the model in depth in Sessions & tokens.
The five-minute path
- In the console, create a tenant, a project, and an environment (e.g.
dev). - Copy the environment's public key (
pk_...): this is all your app needs to validate sessions. - Install the SDK for your stack (below) and configure it with the public key and your API base URL (
NEXT_PUBLIC_API_ENDPOINT). - Add authentication UI: the hosted Account portal for zero-config sign-in, or drop-in components for full control.
- Protect a route with the gate and confirm the session resolves.
Pick your stack
Frontend: sign users in and manage the session in the browser:
- Next.js, React, Remix, SvelteKit, TanStack Start
- Vue / Nuxt, Angular, Astro, Gatsby, RedwoodJS
- React Native / Expo
Backend: validate sessions and call the REST API from your server:
- Node (Express, Fastify)
- Python (FastAPI, Django, Flask)
- Go, Rust
Each SDK exposes the same three primitives with idiomatic bindings for the framework. See the Framework guides for the per-stack walkthroughs.
Next steps
- Guides: task-oriented recipes for multi-tenant apps, SSO, and provisioning.
- Backend requests: verify sessions and protect APIs on the server.
- Components: the drop-in UI reference.