Spotpass: accounts for the apps on a Spotcraft instance, and for the people who run it. One small service, on Better Auth and Postgres, that every app on a server signs its users in with.
- Signs users in on the app's own domain: first-party cookies for the web, bearer tokens and short-lived JWTs for other clients, checked against its public keys.
- Guests first: an app works before anyone signs up; the guest's data stays theirs.
- Data rights built in: a user downloads everything held about them, or deletes themselves, and their rows in every app go with them.
- Keeps little, and not for long: expired sessions go, IP addresses are cleared after 30 days, idle guests are deleted.
- Apps read only what they need: they can point foreign keys at a user's id and read four columns, never emails, sessions or keys.
- Replaceable: it implements Spotcraft's
user pool contract,
written in Kodentuzo's own terms. Another pool that passes the same checks (
the pool contractintest/pool.test.ts) can take its place, and Better Auth's client keeps working with it.
- Better Auth behind Node's own HTTP server, with Drizzle over a Postgres schema it migrates itself.
- A distroless image (
vindotski/spotpass), read-only, with no shell. - Tests against a real Postgres in CI.
Stack: TypeScript, Node 26, Better Auth, Drizzle, Postgres, Docker, GitHub Actions.
Version 0.1, moved out of Spotcraft with its history; Spotcraft 0.13 runs it. A pool per app with email and password and a confirmed email comes next. See the changelog and the wiki.