Lucia 1.0

We are thrilled to announce Lucia v1.0! Watch the announcement video!

Lucia is a server-side authentication library for TypeScript that aims to be unintrusive, straightforward, and flexible.

At its core, it’s a library for managing users and sessions, providing the building blocks for setting up auth just how you want. Database adapters allow Lucia to be used with any modern ORMs/databases and integration packages make it easy to implement things like OAuth.

Here’s what working with Lucia looks like:

const user = await auth.createUser({
	// how to identify user for authentication?
	primaryKey: {
		providerId: "email", // using email
		providerUserId: "[email protected]", // email to use
		password: "123456"
	// custom attributes
	attributes: {
		email: "[email protected]"
const session = await auth.createSession(user.userId);
const sessionCookie = auth.createSessionCookie(session);

It started off as a small JWT-based library for SvelteKit made over summer break. Over the last few months, we switched to sessions, made it framework agnostic, added keys and OAuth support, and cleaned up the APIs. Even with all the breaking changes, it’s still a huge passion project that aims to provide a solution between something fully custom and ready-made.

Our core approach remained the same as well. Simple is better than easy. Things should be obvious and easy to understand. APIs should be applicable to a wide range of scenarios, even when a bit verbose. Being easy is nice at the start, but unfortunately leads to endless configuration and callbacks. We also believe documentation and learning resources are crucial to a library’s success and have spent countless hours on it.

As of writing, the project has over 750 stars and nearly 3,000 weekly downloads. Special thanks to:

and, of course, a big thanks to everyone who has contributed! Valentin Rogg, Blastose, Ingo Krumbein, Felipe dos Santos, Dana Woodman, Alexander Way, captaindirgo, Christopher Pfohl, Jean-Cédric Huet, Johan Karlsson, Oscar Beaumont, Parables Boltnoel, CA Gustavo, Zach, Boian Ivanov, Fabian Merino, Jasper Kelder, Jeremy Schoonover, Jordan Calhoun, Kelby Faessler, Lih Haur Voon, Marvin, Mathis Côté, Oskar, Roga,Thomas Slater, VoiceOfSoftware, hffeka, moka-ayumu, weepy

Ready to update? Read the migration guide!