Limen v0.1.0 — first public release

Limen is a plugin-first authentication library for Go, inspired by better-auth.
This is the initial public release. The API surface is intentional but pre-1.0; minor versions may contain breaking changes, patch versions will not.

Read the announcement: https://limenauth.dev/blog/introducing-limen
Docs: https://limenauth.dev

Install

go get github.com/thecodearcher/limen@v0.1.0

What ships in v0.1.0

Core

• github.com/thecodearcher/limen@v0.1.0 — sessions, cookies, CSRF, rate limiting, email verification, hooks, schema, typed errors

Adapters

• github.com/thecodearcher/limen/adapters/sql@v0.1.0 — database/sql (Postgres, MySQL, SQLite)
• github.com/thecodearcher/limen/adapters/gorm@v0.1.0 — GORM

Authentication plugins

• github.com/thecodearcher/limen/plugins/credential-password@v0.1.0 — email + password
• github.com/thecodearcher/limen/plugins/two-factor@v0.1.0 — TOTP and backup codes
• github.com/thecodearcher/limen/plugins/session-jwt@v0.1.0 — JWT-backed sessions

OAuth

• github.com/thecodearcher/limen/plugins/oauth@v0.1.0 — OAuth 2.0 core with PKCE
• Providers (all @v0.1.0): oauth-generic, oauth-google, oauth-github, oauth-apple, oauth-microsoft, oauth-discord, oauth-facebook, oauth-linkedin, oauth-spotify, oauth-twitch, oauth-twitter

CLI

• github.com/thecodearcher/limen/cmd/limen@v0.1.0 — scaffolding and migrations

Highlights

• Framework-agnostic http.Handler. Drops into net/http, Gin, Echo, Chi, Fiber.
• Bring your own database via adapters/sql or adapters/gorm.
• Type-safe functional-option configuration.
• Secure defaults: HttpOnly + Secure cookies, SameSite=Lax, CSRF protection, session rotation on privilege changes.
• First-class hooks, a clean Plugin interface, custom user fields without forking.

Examples

Runnable examples for net/http, Gin, GORM, OAuth (Google), and two-factor: https://github.com/thecodearcher/limen/tree/master/examples

Requires

• Go 1.25+

Feedback

Issues and PRs welcome. If there's a plugin you want that doesn't exist, open an issue — the plugin interface is designed to be extended.