Repository navigation
Releases: MRJonam91/ZeroAuth
Release list
v1.0.0 - ZeroAuth General Availability
🚀 ZeroAuth v1.0.0 — Stable General Availability (GA)
ZeroAuth is a lightweight, zero-dependency, self-hosted Passkeys & WebAuthn authentication engine designed for modern web apps, indie hackers, and privacy-first architectures.
🌟 What's New in v1.0.0
- 🧩 Zero-Dependency Core (@zeroauth/core): Under 1,000 LOC, standalone zero-dependency CBOR decoder, COSE/WebCrypto validator (ES256, Ed25519), and AAGUID hardware identification (Apple TouchID/FaceID, Windows Hello, YubiKey, Google Titan).
- 🛡️ Enterprise Security & Universal Server (@zeroauth/server): Built-in anti-phishing origin checks, anti-replay challenge verification, cloned authenticator detection via signature counters, in-memory sliding sessions, and token-bucket rate limiting.
- 🔌 Pluggable Storage Adapters: Native SQLite via
ode:sqlite\ (zero native compilation required) and PostgreSQL adapter for distributed production setups. - 🌐 Universal Web Handler: One-line handler (\createZeroAuthHandler) conforming to Web Standards (\Request\ / \Response), compatible with Next.js (App Router), Remix, Astro, SvelteKit, Express, and Fastify.
- ⚛️ Modern React SDK (@zeroauth/react): Ready-to-use hooks (\usePasskey, \useZeroAuth) and plug-and-play UI components (<PasskeyButton>, <PasskeyList>).
- 🎮 Standalone Demo App: Runnable live sandbox demonstrating multi-passkey registration, cross-device authentication, renaming, and credential revocation.
- 📖 Bilingual Documentation: Full documentation and quickstarts available in both English and Italian.
📦 Packages Included
- @zeroauth/core@1.0.0\
- @zeroauth/server@1.0.0\
- @zeroauth/client@1.0.0\
- @zeroauth/react@1.0.0\
🤝 Sponsorship & Commercial Licensing
ZeroAuth is dual-licensed under GNU AGPLv3 (for open source projects) and a Commercial License (for proprietary/closed-source SaaS products or IP acquisition).
Support ongoing development:
- GitHub Sponsors: github.com/sponsors/MRJonam91
- Ko-fi: ko-fi.com/mrjonam
- Buy Me a Coffee: buymeacoffee.com/mrjonam
- PayPal: paypal.me/manorollo
v0.3.0 Beta - Multi-Passkey Management, AAGUID Resolver, Postgres & React UI
🚀 ZeroAuth v0.3.0 Beta Release
We are excited to announce ZeroAuth v0.3.0 Beta! This milestone delivers production-readiness with multi-device passkey backup management, hardware AAGUID model resolution, a production PostgreSQL adapter, sliding-window rate limiting, and ready-to-use React UI components.
✨ What's New in Beta
-
🔑 Multi-Passkey Management:
- Register multiple backup passkeys per user account (e.g. MacBook Touch ID, iPhone Face ID, YubiKey 5 NFC).
- Dedicated REST API routes: \GET /credentials, \PATCH /credentials\ (rename key), and \DELETE /credentials\ (revoke key).
-
🏷️ AAGUID Hardware Model Resolution:
- Automatic identification of hardware authenticators: Apple iCloud Keychain, Touch ID / Face ID, Windows Hello, YubiKey 5 Series, and Google Password Manager.
-
🛡️ Built-in Rate Limiter (Anti-Abuse / DoS Mitigation):
- Sliding-window rate limiter protecting challenge generation endpoints against brute-force attacks and resource exhaustion.
-
🐘 PostgreSQL Storage Adapter (\PostgresStorageAdapter):
- Production SQL driver compatible with standard PostgreSQL, Supabase, Neon, and Vercel Postgres, complete with standard DDL in \docs/postgres-schema.sql.
-
⚛️ Pre-built React UI Components:
- <PasskeyButton>: biometric styled button with customizable variants.
- <PasskeyList>: full interactive passkey management list supporting renaming and revocation.
-
🧪 26 Automated Tests (100% Pass Rate):
- Coverage for CBOR edge-cases, AAGUID resolution, multi-credential workflows, rate limiting, anti-phishing, anti-replay, and clone detection.
-
🪶 Ultra-compact Core Compliance:
- @zeroauth/core\ remains at only 833 LOC, strictly adhering to the < 1,500 LOC rule for zero-bloat transparency.
💖 Support the Project
ZeroAuth is 100% free and open-source under a Dual-Licensing model.
If it saves your project expensive Auth0 / Clerk fees, support ongoing development:
- GitHub Sponsors: https://github.com/sponsors/MRJonam91
- Ko-fi: https://ko-fi.com/mrjonam
- Buy Me a Coffee: https://buymeacoffee.com/mrjonam
- PayPal Direct: https://paypal.me/manorollo
💼 Commercial Licensing & Project Buyout
Distributed under GNU AGPLv3 with Commercial Proprietary Licensing available for closed-source SaaS applications and full IP acquisition: https://github.com/MRJonam91
v0.2.0 Alpha - Universal Handler, Sessions, React Provider & Security Suite
🌟 ZeroAuth v0.2.0 Alpha Release
We are proud to release ZeroAuth v0.2.0 Alpha, bringing the self-hosted Passkeys & WebAuthn engine to full framework readiness with sessions, universal HTTP routing, and complete React state management!
🚀 What's New in Alpha
-
🌐 Universal Web Standard Handler (\createZeroAuthHandler):
- Zero-boilerplate integration with Next.js App Router, Hono, SvelteKit, Astro, Bun, and Node.js.
- Built on standard Fetch API \Request\ -> \Response\ with automatic cookie handling.
-
🔐 Cryptographic Session Manager (\SessionManager):
- Secure opaque session tokens with sliding expiration and persistent storage across SQLite and In-Memory adapters.
- Automatic revocation on logout and automated session pruning.
-
⚛️ Full React Authentication Provider (<ZeroAuthProvider>\ & \useZeroAuth()):
- Centralized authentication context in @zeroauth/react\ providing global reactive \user, \isAuthenticated, \login(),
egister(), and \logout().
- Centralized authentication context in @zeroauth/react\ providing global reactive \user, \isAuthenticated, \login(),
-
🛡️ Standardized Client Errors (\ZeroAuthClientError):
- Normalized browser DOMExceptions to friendly error codes (\USER_CANCELLED, \TIMEOUT, \NOT_SUPPORTED, \INVALID_STATE).
-
🧪 Comprehensive Security & Edge Case Test Suite:
- 20 unit and integration tests passing with 100% success rate:
- Anti-Phishing origin validation
- Anti-Replay challenge binding
- Cloned authenticator detection via counter validation
- CBOR decoding boundary and truncation resilience
- 20 unit and integration tests passing with 100% success rate:
-
🪶 Ultra-compact Core:
- Maintained under the strict < 1,500 LOC rule (@zeroauth/core\ at only 738 LOC) with zero external dependencies.
💖 Support Ongoing Development
ZeroAuth is built for indie hackers, developers, and open-source advocates.
Support the project:
- GitHub Sponsors: https://github.com/sponsors/MRJonam91
- Ko-fi: https://ko-fi.com/mrjonam
- Buy Me a Coffee: https://buymeacoffee.com/mrjonam
- PayPal Direct: https://paypal.me/manorollo
💼 Commercial Licensing & IP Acquisition
Dual-licensed under GNU AGPLv3 and Commercial Proprietary License. For proprietary SaaS, enterprise licensing, or full IP acquisition inquiries: https://github.com/MRJonam91
v0.1.0 MVP - First Functional WebAuthn & Passkeys Engine
🚀 ZeroAuth v0.1.0 MVP: Self-Hosted Passkeys & WebAuthn Engine
We are excited to announce the first functional MVP of ZeroAuth — a modern, self-hosted, decentralized authentication suite powered by standard W3C WebAuthn Level 3 and hardware Passkeys (Touch ID, Face ID, Windows Hello, YubiKey).
✨ MVP Highlights
- 🪶 Core < 1,500 LOC (732 LOC achieved): Ultra-compact, dependency-free cryptographic engine in pure TypeScript.
- 📦 Embedded CBOR & COSE Decoder: RFC 8949 compliant binary decoder (< 150 LOC) parsing \�ttestationObject\ and COSE public keys without external bloatware.
- 🔐 WebCrypto Native: Standard cryptographic operations (\crypto.subtle) for SHA-256 digests, ASN.1 DER to IEEE P1363 signature conversions, and ECDSA P-256 / Ed25519 signature validations.
- 🗄️ Zero-Config SQLite Adapter: Integrated \SqliteStorageAdapter\ utilizing Node.js 22/24 native
ode:sqlite\ (no native compilation required). - 🎮 Interactive Standalone Demo: Complete runnable demo in \examples/standalone-demo\ to test biometric registration and login in your browser.
- 🛡️ Steganographic Provenance: Embedded cryptographic watermarks for author attribution and IP verification.
🏃 Quickstart: Run the Interactive Demo
\\�ash
git clone https://github.com/MRJonam91/ZeroAuth.git
cd ZeroAuth
npm install
npm run build
node examples/standalone-demo/server.mjs
\\
Open \http://localhost:3000\ in your browser to create and test hardware Passkeys!
💖 Support & Donations
If ZeroAuth helps you save hundreds of dollars on Auth0 or Clerk bills, please support ongoing maintenance:
- GitHub Sponsors: https://github.com/sponsors/MRJonam91
- Ko-fi: https://ko-fi.com/mrjonam
- Buy Me a Coffee: https://buymeacoffee.com/mrjonam
- PayPal Direct: https://paypal.me/manorollo
💼 Commercial Licensing & IP Acquisition
ZeroAuth is distributed under a Dual-Licensing model (GNU AGPLv3 + Commercial License).
- Free for open-source projects complying with AGPLv3.
- Commercial proprietary licenses available for closed-source SaaS products, enterprise distributions, or full project acquisition.
- Contact: https://github.com/MRJonam91