Never forget how you signed up. Never leave an account unshielded.
A zero-knowledge personal ledger for tracking authentication methods, auditing 2FA coverage, and generating cryptographically secure credentials entirely in your browser.
Core Problem β’ Key Features β’ Security Health Engine β’ Directory Structure β’ Getting Started β’ Deployment β’ Keyboard Shortcuts
Modern web users hold hundreds of accounts across online services. The biggest point of friction and security vulnerability is authentication sprawl:
- Did you sign up with Sign in with Google, your personal email, an Apple relay address, or a temporary disposable inbox?
- Which critical services still lack Two-Factor Authentication (2FA)?
- Where have you stored passwords that need rotation?
- Cloud-based password managers are frequent targets of high-profile data breaches.
KeyHold solves this by acting as your offline-first personal authentication ledger. All data resides exclusively in your browser's local sandbox (localStorage). No servers, no tracking, no subscription fees.
- Authentication Method Tracking: Categorize accounts by sign-in type:
Google / OAuth,Email & Password,Phone / SMS,Temporary Email, orPasskeys / WebAuthn. - Verification Vectors: Record verification types:
OAuth,OTP,Password,Magic Link, andPasskey. - Provider Identity Badges: Auto-renders visual brand badges and icons for services like Google, GitHub, Apple, Discord, Twitter, and custom URLs.
KeyHold runs continuous real-time diagnostic checks across your account ledger:
- 2FA Audit: Highlights accounts without two-factor authentication enabled.
- Vulnerability Scorer: Calculates an overall Health Percentage score based on 2FA adoption, password hygiene, and verification safety.
- Duplicate Password Detection: Warns if the same password string is reused across multiple services.
- Archival Status: Mark stale accounts as
Active,Inactive, orArchivedto keep your digital footprint tidy.
- Built on the native Web Crypto API (
window.crypto.getRandomValues), avoiding predictable pseudorandom math. - Configurable character sets: Uppercase (
A-Z), Lowercase (a-z), Digits (0-9), and Special Symbols (!@#$%^&*). - Avoid ambiguous characters (
l,1,I,O,0) with 1-click preset lengths (12 to 64 characters).
- Auto-Masking: Passwords and sensitive identifiers are masked by default. Reveal them with a momentary click.
- Clipboard Auto-Purge: Automatic background timer purges copied passwords from your operating system clipboard after 15, 30, or 60 seconds.
- 100% Offline-First: Zero network requests are made. Inspect the network tabβKeyHold functions seamlessly completely disconnected from the internet.
Switch between 3 distinct presentation modes depending on your workflow:
- Card (Grid) Mode: Rich cards with category badges, security tags, notes, and visual actions.
- List (Table) Mode: Compact table view with sortable columns for fast scanning.
- Compact (Dense) Mode: Ultra-dense list layout ideal for large collections of 200+ accounts.
Choose from curated themes tailored for day and night:
- Themes: Slate, Obsidian, Midnight, Forest, and Amber.
- System-aware automatic dark/light theme switching.
- Font scaling adjustments:
Small,Medium, andLarge.
- Instant keyboard-driven lookup across service names, usernames, tags, and categories.
- Trigger quick actions: Create new account, toggle dark mode, export backup, or audit security health.
- Full JSON Export / Import functionality.
- Easily migrate your encrypted ledger between browsers, machines, or cold storage drives.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Client Browser β
β β
β [User Input] βββΊ [Input Sanitation & Normalization] β
β β β
β βΌ β
β [Security Health Auditor & Strength Evaluator] β
β β β
β ββββββββββββββββββ΄βββββββββββββββββ β
β βΌ βΌ β
β [State Dispatcher] [Web Crypto Generator] β
β β β
β βΌ β
β [Local Storage Adapter] (Encrypted JSON payload) β
β β β
β βΌ β
β [Command Palette (βK) & Responsive Multi-Layout Views] β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
export interface Account {
id: string;
service: string;
url?: string;
iconUrl?: string;
signInMethod: 'gmail' | 'email' | 'phone' | 'tempmail' | 'other';
identifier?: string;
verification: 'oauth' | 'otp' | 'password' | 'magiclink' | 'passkey';
password?: string;
savePassword: boolean;
category: string;
tags: string[];
notes?: string;
twoFactor: boolean;
favorite: boolean;
status: 'active' | 'inactive' | 'archived';
username?: string;
recoveryEmail?: string;
backupCodes?: boolean;
createdAt: string;
updatedAt: string;
}web/KeyHold/
βββ public/ # Static web icons and manifest assets
βββ src/
β βββ components/ # Accessible modular UI components
β β βββ AccountCard.tsx # Grid card with interactive actions & 2FA badge
β β βββ AccountListItem.tsx # Row item for table and compact view modes
β β βββ AccountModal.tsx # Comprehensive account creation & edit form
β β βββ CommandPalette.tsx # βK instant search & global action dispatcher
β β βββ ConfirmDialog.tsx # Modal confirmation for destructive deletes
β β βββ Field.tsx # Accessible form input & validation wrapper
β β βββ SecurityHealth.tsx # Real-time health scoring & vulnerability report
β β βββ ServiceIcon.tsx # Dynamic brand icon generator with fallbacks
β β βββ SettingsPage.tsx # Theme selector, font scaling, clipboard settings
β β βββ StatsBar.tsx # Quick stat chips (Total, 2FA %, Passwords, Favs)
β β βββ Toast.tsx # Micro-interaction notifications
β βββ lib/ # Core ledger logic, storage & encryption
β β βββ hooks.ts # Custom React hooks (settings, keyboard listeners)
β β βββ meta.tsx # Icons & metadata for sign-in methods & categories
β β βββ store.ts # LocalStorage CRUD, export/import & password generator
β β βββ themes.ts # Palette definitions (Slate, Midnight, Forest, Amber)
β β βββ types.ts # Strong TypeScript interfaces and schemas
β β βββ utils.ts # Styling helpers (clsx/cn) and sanitizers
β βββ App.tsx # Main layout coordinator, filter pipeline & hotkeys
β βββ index.css # Tailwind CSS v4 design tokens and theme variables
β βββ main.tsx # React 19 entry point
βββ eslint.config.js # ESLint 9 configuration
βββ index.html # Single Page Application HTML5 entry point
βββ package.json # Dependencies and build scripts
βββ tsconfig.json # TypeScript compiler configuration root
βββ tsconfig.app.json # App-specific TS rules
βββ tsconfig.node.json # Vite/Node configuration
βββ vite.config.ts # Vite 7 build configuration with Tailwind plugin
- Node.js:
v20.xor later - Package Manager:
npm,pnpm, orbun
-
Navigate to the project directory:
cd /home/code/projects/web/KeyHold -
Install dependencies:
npm install
-
Start the development server:
npm run dev
Open
http://localhost:5173in your browser.
| Command | Description |
|---|---|
npm run dev |
Runs the Vite local development server with HMR. |
npm run build |
Validates TypeScript types and compiles static bundle into dist/. |
npm run preview |
Runs a local web server to preview the production build. |
npm run lint |
Runs ESLint across all TypeScript and React components. |
KeyHold is a completely static, zero-backend Single Page Application (SPA). It can be deployed to any static host or CDN in seconds.
# Build the project
npm run build
# Deploy to Cloudflare Pages
npx wrangler pages deploy dist --project-name keyholdSimply link the repository to Vercel or GitHub Pages:
- Framework:
Vite - Build Command:
npm run build - Output Directory:
dist
| Key | Description |
|---|---|
βK / Ctrl+K |
Open / Close Command Palette |
N |
Open "Add New Account" modal |
/ |
Focus search bar |
Esc |
Close active modal, drawer, or clear search |
? |
Toggle keyboard shortcuts guide |
- Zero Network Footprint: KeyHold does not possess an external API client or analytics beacon. Your credentials never touch the wire.
- Local Sandboxing: Data is bound to your browser's origin. Extensions without storage permissions cannot access the ledger.
- Browser Storage Advisory: Because data is kept in
localStorage, clearing your browser history or site data will delete your vault. Always maintain an exported JSON backup in a secure location.