EpokK/pixel-authenticator

A cyberpunk-themed 2FA authenticator with gamification features. Generate TOTP codes, collect special sequences, and unlock achievements!

โ˜… 0Forks 0TypeScriptGitHub โ†—Compare

Project website โ†—

2faauthenticationtotp

README

๐ŸŽฎ Pixel Authenticator

A cyberpunk-themed 2FA authenticator with gamification features. Generate TOTP codes, collect special sequences, and unlock achievements!

โœจ Features

  • 2FA Authentication: Generate TOTP codes with QR scanning and manual entry
  • Gamification: Collect special sequences (123456, 777777, etc.) and unlock achievements
  • Cyberpunk Theme: Dark backgrounds with neon colors and pixel-perfect UI
  • Multiple Input Methods: Manual URI, QR image upload, or live camera scanning
  • Offline Ready: All data stored locally, no servers required

๐Ÿš€ Quick Start

# Clone and install
git clone https://github.com/EpokK/pixel-authenticator.git
cd pixel-authenticator
npm install

# Start development server
npm start

Open http://localhost:3000 in your browser.

๐ŸŽฎ How to Use

  1. Add Authenticator: Click "ADD NEW" and choose your method (manual, upload QR, or scan with camera)
  2. Generate Codes: View your 2FA codes with countdown timers
  3. Collect Sequences: Special patterns are automatically detected and added to your collection
  4. View Collection: Click "๐Ÿ† COLLECTION" to see your findings and achievements

๐Ÿ› ๏ธ Tech Stack

  • Frontend: React 19 + TypeScript + Tailwind CSS
  • TOTP: CryptoJS (RFC 6238 compliant)
  • QR Codes: jsQR + qr-scanner
  • Storage: Local browser storage only

๐ŸŽจ Customization

Edit tailwind.config.js to modify the cyberpunk color palette:

'pixel': {
  'bg': '#0a0a0f',      // Deep black background
  'accent': '#ff2a6d',   // Hot pink accent
  'green': '#01ff89',    // Matrix green
  'yellow': '#fff01f',   // Electric yellow
  // ... more colors
}

๐Ÿš€ Deployment

npm run build

Deploy the build/ folder to any static hosting service (Netlify, Vercel, GitHub Pages, etc.).

๐Ÿ”’ Security

  • 100% client-side - no data leaves your device
  • Standards compliant TOTP implementation
  • No tracking or analytics

๐Ÿ“„ License

MIT License - feel free to fork and customize!


Happy collecting! ๐Ÿ† Hunt for legendary sequences like 123456!

Contributors

EpokK

Issues