Authentication

Koolbase Auth handles user registration, login, sessions, email verification, and password reset for your app's users — not the Koolbase dashboard.

How it works

Each Koolbase project has its own isolated user store per environment. When a user registers in your app, they are stored in your project — completely separate from other projects and from Koolbase dashboard accounts.

Sessions are JWT-based. On login, the SDK receives a token and stores it securely on the device using flutter_secure_storage. The token is automatically included in all subsequent SDK requests.

Scoped per environment

Users registered in your production environment are separate from users in staging or development. Each environment has its own independent user store.

What's included

Database tables

Koolbase Auth uses four tables per project, all scoped to your environment:

project_usersApp user accounts — email, hashed password, verification status
project_sessionsActive JWT sessions per user and environment
project_password_resetsTime-limited password reset tokens
project_oauth_accountsOAuth provider links (Google)