Skip to content
ii2dPublic

About

Zero-knowledge, local-first 2FA/TOTP authenticator PWA built with Svelte 5 & Argon2id

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

vault2fa

A modern, zero-knowledge, local-first 2FA/TOTP authenticator PWA built with Svelte 5 and WebAssembly encryption.

Version CI License: MIT Security: Threat Model Svelte 5 TypeScript PWA

🌐 Live App: https://2fa.ii2d.com


✨ Features

  • 🔒 Zero-Knowledge Encryption: Argon2id WASM key derivation + hardware-accelerated AES-256-GCM (crypto.subtle).
  • ⚡ Ultra-Fast (Svelte 5): Lightweight footprint with fine-grained reactivity and instant app startup.
  • 📱 Offline PWA: Full offline functionality and installable on iOS, Android, macOS, Windows, and Linux.
  • 🔑 Hardware-Backed Biometrics: Secure Enclave unlock via WebAuthn PRF extension (Touch ID, Face ID, Windows Hello, YubiKey).
  • 🔄 Decentralized Sync: Local File System binding (iCloud/Dropbox/Syncthing) or encrypted GitHub Gist sync with QR pairing.
  • 📦 Broad Import & Export: One-click import from Google Authenticator, Aegis, Bitwarden, and plain URI lists, plus printable Recovery Kits.
  • 🛡️ Zero Tracking & Egress Control: Strict Content Security Policy (CSP), zero telemetry, sanitized backup exports, and zero server dependencies.

🛠️ Tech Stack


🚀 Quick Start

# 1. Clone the repository
git clone https://github.com/ii2d/vault2fa.git
cd vault2fa

# 2. Install dependencies
pnpm install

# 3. Start dev server
pnpm run dev

⚙️ Custom Branding & Configuration

Copy .env.example to .env to customize branding and links without editing source code:

VITE_APP_NAME="Vault2FA"
VITE_APP_TITLE="Zero-Knowledge TOTP Authenticator"
VITE_APP_DESCRIPTION="Privacy-first 2FA authenticator"
VITE_APP_URL="https://2fa.ii2d.com"
VITE_APP_REPO_URL="https://github.com/ii2d/vault2fa"

To deploy your own copy for free on GitHub Pages, fork the repo and enable GitHub Actions under Settings > Pages.


🔒 Security & Threat Model

For a detailed breakdown of our cryptographic primitives, key derivation parameters, hardware biometric wrapping via WebAuthn PRF, in-scope threat mitigations, and responsible vulnerability disclosure policy, please see our dedicated SECURITY.md.


📄 License

This project is open-source and licensed under the MIT License.

About

Zero-knowledge, local-first 2FA/TOTP authenticator PWA built with Svelte 5 & Argon2id

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages