Skip to content
kodentuzoPublic

About

Accounts for apps and for a Spotcraft instance's admins, on Better Auth

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Spotpass

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.

What it does

  • 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 contract in test/pool.test.ts) can take its place, and Better Auth's client keeps working with it.

How it's built

  • 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.

Status

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.

License

Apache-2.0.

About

Accounts for apps and for a Spotcraft instance's admins, on Better Auth

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages