Entity Auth

Getting Started

Everything you need to get started with Entity Auth

Getting Started

Entity Auth provides password auth, organizations, sessions, and device‑level security for web and Swift apps.

Install

The web SDK is included in this repo under packages/sdk. Swift apps import EntityKit.

Configure environment

Set these variables in your runtime:

  • NEXT_PUBLIC_CONVEX_URL: Convex deployment URL used by realtime watchers
  • JWT_SECRET: HS256 secret for issuing short‑lived access tokens

See the Environment page for details.

First call

import { EntityAuthClient } from "@/packages/sdk/src";
const ea = new EntityAuthClient();
await ea.register({ email: "user@example.com", password: "hunter2", tenantId: "t1" });
await ea.login({ email: "user@example.com", password: "hunter2", tenantId: "t1", platform: "web" });

Next, explore Authentication, Sessions, and Organizations.

Explore