Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.osschat.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

OpenChat uses Better Auth with GitHub OAuth, then syncs users into Convex. OpenChat GitHub OAuth sign-in screen in dark mode

​
Request Flow

​
Key Implementation Points

  • Client auth state from auth-client.tsx via useAuth().
  • Server-side auth helpers in server-auth.ts.
  • Root route preloads session in routes/__root.tsx.
  • Route-level guards in pages such as routes/c/$chatId.tsx and routes/settings.tsx.

​
Required Variables

GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
BETTER_AUTH_SECRET=...
VITE_CONVEX_SITE_URL=...
Callback URL must target the Convex site URL host: /api/auth/callback/github.

​
Security Notes

  • Same-origin checks are enforced on sensitive server handlers.
  • Convex user identity is validated before database access.
  • Rate limits protect auth-adjacent workflow endpoints.