Skip to content

πŸŽ‰ Personal 2FA v1.0.0 - Initial Release

Latest

Choose a tag to compare

@lfern lfern released this 26 Oct 15:20
· 2 commits to main since this release

πŸŽ‰ Welcome to Personal 2FA!

The first stable release of Personal 2FA - a secure, self-hosted TOTP authenticator with advanced encryption and multi-format backup support.

✨ Features

  • πŸ” Military-grade encryption - AES-256-GCM for local storage
  • πŸ“± Google Authenticator compatible - Import QR codes directly
  • πŸ’Ύ Multiple backup formats - JSON, encrypted files (OpenSSL compatible)
  • 🌐 Bilingual support - Spanish and English interfaces
  • ⚑ Offline-first - No servers, no tracking, works completely offline
  • πŸ”§ Self-hosted - Deploy anywhere, full control over your data
  • πŸ“‹ Bulk operations - Import/export multiple codes at once
  • 🎨 Modern UI - Clean, responsive design

πŸ›‘οΈ Security Highlights

  • Client-side encryption - All data encrypted before storage
  • Master password protection with PBKDF2 key derivation
  • Secure backup - OpenSSL AES-256-CBC compatible exports
  • No telemetry - Zero data collection or external requests
  • Memory protection - Sensitive data cleared after use

πŸš€ Quick Start

  1. Download the release files
  2. Extract and open index.html in your browser
  3. Set up your master password
  4. Import codes from Google Authenticator or add manually

πŸ“‚ What's Included

  • personal-2fa.html - Standalone application file (all-in-one)
  • dist/ - Distributed files for web hosting
  • docs/ - Documentation and guides

πŸ”§ Technical Details

  • Framework: Vanilla JavaScript ES2022
  • Storage: IndexedDB with AES-256-GCM encryption
  • Crypto: Web Crypto API + OpenSSL compatibility
  • Build: Custom ES modules to standalone converter

πŸ› οΈ Installation

Option 1: Standalone File

Simply download personal-2fa.html and open it in your browser. No server required!

Option 2: Web Hosting

Download and extract dist/ folder to your web server.

Option 3: Build from Source

git clone https://github.com/lfern/personal-2fa.git
cd personal-2fa
node [build.js](http://_vscodecontentref_/0)

πŸ†• What's New in v1.0.0

This is the initial release featuring:

  • Complete TOTP management system
  • Advanced encryption and security
  • Multiple import/export formats
  • Comprehensive internationalization
  • Modern user interface
  • Extensive error handling

🀝 Contributing

Contributions are welcome! Please check out our Contributing Guide for details.

πŸ“„ License

MIT License - see LICENSE file for details.

πŸ”— Links:

Documentation
Security Guide
Report Issues

⭐ If you find this project useful, please consider giving it a star!