peach-browser
A free, open source, local-first password manager for Chrome, Firefox, and Android.
TypeScript
timeline
atlas269 files
public/
codex/
fonts/
models/
scripts/
build-peachscript.pyBuild PeachScript-Regular.otf — 256 historical-runic glyphs.ci.tsclean-chrome-dist.mjsclean-firefox-artifacts.mjspackage-amo-source.shpackage-amo-source.sh — produce peach-3.6.65-source.zip for AMO review.release-firefox.tsrelease.tssetup-chrome-release.sh───────────────────────────────────────────────────────────────────────────── Peach — Chrome Web Store Release Setup Run this once to configure Chrome publishing.sync-chrome-dist.mjs
src/
background/
aes.test.tsaes.tsaes.ts — AES-256-GCM encrypt/decrypt primitives for vault storage.alarms.test.tsalarms.tschirp-identity.tsLocal-device identity helpers for the chirp-sync architecture.chirp-sync-coordinator.test.tschirp-sync-coordinator.tsChirp Sync — Phase 2 manifest-diff coordinator.chirp-sync-runner.test.tschirp-sync-runner.tsProduction sync runner — composes the live vault adapter, WebSocket transport, and coordinator into the function the dispatcher injects via
setSyncRunner.chirp-sync-static.test.tsIV.7 — Static safety assertions for Chirp Sync.chirp-sync-vault-adapter.test.tschirp-sync-vault-adapter.tsProduction adapter that backs runChirpSyncInitiator with the live vault.clipboard.test.tsclipboard.tscodex-handlers.test.tsTests for src/background/codex-handlers.ts.codex-handlers.tscodex-handlers.ts — message handlers that back the Peach Codex flow.commands.tsKeyboard command handler — routing for summon-inline: 1.entry.tshealth.test.tshealth.tshealth.ts — Pro advanced vault health analysis.index.tslicense.tsmessages.adversarial.test.tsmessages.adversarial.test.ts — Layer 3 §3.3 adversarial message handler tests.messages.test.tsmessages.tsmessages.ts — the only background message handler.ml.tsnotes.test.tspaired-devices.test.tspaired-devices.tsPaired-device registry — v3 chirp-sync.passkey-chrome-ceremony.test.tspasskey-chrome-ceremony.test.ts — covers the Chrome chrome.webAuthenticationProxy ceremony path that the Firefox-proxy test file does NOT exercise.passkey-crypto.test.tspasskey-crypto.tspasskey-deny-on-close.test.tspasskey-deny-on-close.test.ts — M8/COR-009passkey-firefox-proxy.test.tspasskey-firefox-proxy.test.ts — covers the v2.12.0 Firefox content-script proxy path.passkey.tsrecovery-pending.tsPersistent flag set while the user has just created a vault and is reading their 12 recovery words but has not yet typed the 3 confirmation words.recovery-words.test.tsrecovery.adversarial.test.tsrecovery.adversarial.test.ts — Layer 3 §3.2 adversarial recovery words tests.self-test.test.tsself-test.tsself-test.ts — Known-Answer Test (KAT) for the Peach crypto stack.sync-trigger.test.tssync-trigger.tssync-trigger.ts — central sync dispatcher.vault-history.test.tsVault history tests.vault.adversarial.test.tsvault.adversarial.test.ts — Layer 3 §3.1 adversarial vault tests.vault.test.tsvault.tsvault.ts — sole owner of vault state and chrome.storage vault keys.content/
passkey-toast/
crypto/
argon2.test.tsargon2.tscrypto.test.tspeachPayload.test.tspeachPayload.tspeachPayload.ts — binary payload format shared by PeachScript and the Peach QR matrix code (spec §2).peachScript.test.tspeachScript.tspeachScript.ts — PeachScript encoding/decoding.totp.tszstd.tsThin wrapper around @bokuweb/zstd-wasm that defers WASM load until the first compress/decompress call and memoises the init promise.
popup/
codex/
aztec.tsaztec.ts — Aztec 2D barcode generation with round-trip verification.browser-bundle.test.tscodex.adversarial.test.tscodex.adversarial.test.ts — Layer 3 §3.4 adversarial Codex tests.codex.suite.test.tscodex.suite.test.ts — cross-cutting regression suite for the Codex pipeline.codex.test.tsconfirmation.tsPick 3 distinct positions in [1, 12] for the recovery-words confirmation gate.erasure.tserasure.ts — Reed-Solomon erasure coding around the WASM library.generate.test.tsgenerate.tsgenerate.ts — full Codex generation pipeline.helpers.tshelpers.ts — shared utilities for Codex generation and restoration.node-wasm.tsNode-only WASM byte loader for Vitest.pdf-import.test.tspdf-import.test.ts — coverage for the testable surface of the PDF import path.pdf-import.tspdf-import.ts — restore from a Codex PDF instead of a camera scan.pdf-layout.tspdf-layout.ts — A4 Codex page geometry shared between the generator and the PDF importer.pdf.tspdf.ts — render the printable Codex PDF.reed-solomon.tsBrowser-safe wrapper around the Reed-Solomon WASM exports.restore.test.tsrestore.test.ts — coverage for ChunkBuffer, parseRawScan, reconstructAndVerify.restore.tsrestore.ts — Peach Codex restoration library (popup-side).rs-loader.tsrs-loader.ts — load the Reed-Solomon erasure WASM module.scanner.tsscanner.ts — camera-based Aztec scanning for Codex restoration.
components/
views/
Add.tsxChirpSync.tsxChirpSync — the v3 Settings → Sync surface.CodexGenerateView.test.tsx@vitest-environment jsdomCodexGenerateView.tsxPeach Codex — generation view.CodexRestoreView.tsxPeach Codex — restoration view.contracts.test.tsx@vitest-environment jsdomEntry.tsxExport.csv.test.ts@vitest-environment jsdomExport.tsxSignal-conditioned views in this file must use <Show>, never a signal-conditioned early return (
if (signal()) return <X/>).Health.test.tsx@vitest-environment jsdomHealth.tsxImport.tsxSignal-conditioned views in this file must use <Show>, never a signal-conditioned early return — see Projects.md §4.1.Lock.tsxNoteEditor.toHtml.test.ts@vitest-environment jsdomNoteEditor.tsxNotesEditor.tsxNotesMode.tsxNotesTOC.tsxOnboarding.tsxPanic.tsxPasskeyApproval.tsxProCelebration.tsxRecoveryWordDisplay.tsxRecoveryWordEntry.tsxSettings.tsxTrashView.tsxVault.tsxview-test-utils.tsxshared/
backup.test.tsbackup.tsbridge.tsbrowser.test.tsbrowser.test.ts — locks down feature-detected browser identification.browser.tsbrowser.ts — feature-detected browser identifier shared by background, popup, and content scripts.chirp-handshake.test.tschirp-handshake.tsPost-chirp pairing handshake.chirp-pairing.test.tschirp-pairing.tsAudio pairing driver — orchestrates the two-chirp exchange that bootstraps trust between two devices in the same room.chirp-payload.test.tschirp-payload.tsAudio pairing payload — 64 bytes on the wire.chirp-sync-transport.test.tsSubnet-probe rate-limit tests.chirp-sync-transport.tsWebSocket sync transport — v3 chirp-sync Phase 2.codex-types.tscodex-types.ts — shared shapes for the Peach Codex.config.tsWeb3Forms access key for the in-app feedback form (Settings → feedback).device-manifest.test.tsdevice-manifest.tsDevice manifest — v2 brief §4.3.domain.tsfavicon.test.tsfavicon.tsResolves a favicon URL for a given domain.generate.test.tsgenerate.tsggwave.test.tsggwave.tsggwave loader — thin async wrapper around the ggwave-wasm module.import.test.tsimport.ts
any is intentional throughout this module (L17/I3/QUA-010): import files are user-supplied external JSON whose schemas vary by source app and version (1Password CPG, Bitwarden, CXF, generic CSV).local-network.tsLocal network discovery — minimal helper used by chirp pairing.ml.tsnative.tsMobile platform detection helpers used by popup views to gate Capacitor-only paths.noise-js.test.tsNoise NK auth proof regression test.noise-js.tsNoise NK initiator for Android / Capacitor.noise-xx.test.tsnoise-xx.tsNoise XX (mutual auth) — used for every Phase-2 WebSocket connection after the audio chirp pairing has stamped each side into the other's paired-device registry.passkey-flags.tspasskey-flags.ts — single switch for the Firefox passkey content-script proxy.passkey-utils.test.tspasskey-utils.tspasskey-utils.ts — WebAuthn relying-party-id validation.recovery-word-list.tsrecovery-word-list.ts — 2048-word recovery word list for Peach vault recovery.recovery-words.tsrecovery-words.ts — BIP39-compatible recovery word encoding for Peach vault recovery.shortcuts.test.ts@vitest-environment jsdomshortcuts.tsshortcuts.ts — keybinding schema, defaults, matcher, formatter.storage.tssync-identity.test.tssync-identity.tsSync identity — long-term X25519 keypair tied to the vault, not the device installation.sync-types.tsChirp Sync — type definitions (Master Brief v2).types.tstypes.ts — cross-boundary types and the MessageType union.tests/
fixtures/
history
9dbaabc827acconsolidate native helpers in messages.ts: import isNativePlatform/nativePlugin from shared/native; resolve Capacitor SyncPlugin at call time via syncBridge(); fix buildIdentitySuggestions to surface real entry email per username5 months agod1b56b8c77deremove dead handlers START_PAIRING/START_PEER_DISCOVERY/STOP_PEER_DISCOVERY/INITIATE_PAIR_WITH_PEER/CONNECT_WITH_CODE; drop desktopTriggerSync stub; strip MessageType; simplify SyncPairing.tsx — show-code-only flow5 months ago8d53fdb48f58remove dead sync code: sync-coordinator.{ts,test.ts}, sync-wire.{ts,test.ts}, and unused SyncMessage/PairingStep/NoiseHandshakeResult/SyncState types5 months ago2b0132a81b0bremove 5 orphaned files: content/palette.ts, content/field-scoring.ts, popup/components/{Pip,Ring,TOTP}.tsx5 months ago0b15ab269010before phase 2 — pre-release audit cleanup5 months ago1270aea8b3c2add auditmay82026.md — phase 1 read-only audit report (no source changes)5 months ago336c0344b937lower flick velocity threshold 0.4→0.2 px/ms for more responsive bottom-sheet swipe-up5 months ago7c377a164f3ffix verify-words button text vertical alignment: drop padding-top:16px override that broke .peach-btn's symmetric padding; bump 2.35.3 → 2.35.45 months agoc240545ec276fix recovery rune mask: drop bottom band (was 430-520px) so runes never overlap verify-words button; bump 2.35.2 → 2.35.35 months agoe4ad9ea87ac1bump version 2.35.1 → 2.35.2 across manifest.json, manifest.firefox.json, package.json5 months ago40f29777e553fix undefined CSS vars: replace dead --ac-r/g/b with color-mix(--peach-accent); add aliases for --peach-t4, --peach-text-dim, --peach-bg-card, --peach-border, --peach-mono5 months ago60d971d11986fix stale Export menu test (two formats not three) and guard document.fonts in RecoveryRuneBackground for jsdom — 261/261 passing5 months ago25d2a3259624drop 7 unused npm deps: @stablelib/random, eff-diceware-passphrase, webextension-polyfill, onnxruntime-web, @noble/{ciphers,curves,hashes}5 months ago067a4c1040d9remove unused message handlers (CHECK_BREACH, GET_PASSKEYS, DELETE_PASSKEY, CANCEL_PAIRING) and vault.hasDecoyVault export5 months ago9afd3558b9e8rewrite stale Rust host comment references in noise-js, noise-js.test, sync-types5 months ago923817147387remove dead INCOMING_PAIRING_REQUEST listener branch in App.tsx; remove debug console.log on settings tap5 months ago46415895f157merge duplicate TRIGGER_SYNC + START_PAIRING_SERVER cases; remove dead startSubnetScan stub and activeDesktopPairing vars5 months ago0cee4e9ef31cdelete orphaned sync files: src/sync/, capacitor-sync-transport, sync-identity-glue, ml-detector, DiscoveredPeer type5 months ago18b8a770ad1ebefore peach-browser pre-release audit5 months agoad87fee15001fix bottom-sheet positioning + Settings unreachable: render mobile vault sheet via Solid Portal at document root (was inside .peach-shell whose CSS animations apply transform, trapping position:fixed); add chrome.runtime.getManifest() stub to chrome shim (Settings.tsx calls it at module init, throwing TypeError that left Suspense fallback hung forever); sheet now hidden off-screen at rest5 months ago264e3339f4cdimplement progressive bottom-sheet drag for vault list on native: always-mounted .peach-vault-sheet wrapper with rest position translateY(calc(100% - 60px)) (peek bar visible) and is-open class for translateY(0). Touch handlers in App.tsx track 1:1 finger position via sheetTranslate signal, disable transition during drag, snap to open/closed at touchend by velocity (>0.4 px/ms) or position (50% threshold). Horizontal swipes >16px without matching vertical motion abort so entry-nav stays usable. Also instrument settings gear click with console.log to diagnose unreachable setting nav5 months ago9a83c9b80541App.tsx onMount: on native, treat unconfirmed-recovery + locked + vault-exists as a failed creation — wipe vault slots + recovery-pending flag and restart onboarding. Per user spec: vault creation is atomic with recovery-words confirmation, partial creations don't strand the user behind a password screen. Desktop keeps the resume-via-unlock flow (closing a popup is too easy to do accidentally)5 months agof23a453c4bdaApp.tsx: bottom-sheet swipe gesture on native — touchstart in bottom 40% + swipe up >60px reveals vault list (setView 'list'); touchstart in top 35% of list + swipe down dismisses (setView 'entry'); horizontal moves >30px abort so entry-swipe-nav still works5 months agob39a7b800795RecoveryWordDisplay: replace navigator.share (no-op without @capacitor/share) with a true file download via base64 data URL on native (caught by MainActivity.setDownloadListener and written to public Downloads via MediaStore); button label always reads 'download as .txt'5 months ago4bb8cb4b18bcfix onboarding state persistence: Onboarding.tsx no longer writes peach_onboarded='true' on completion (caused stranded users mid-vault-creation with no back path on Android); App.tsx still persists when vault actually exists, so the flag tracks reality not intent. Also wire peach:back event handler in App.tsx to take the user back to onboarding from create-vault, and to handle in-app surface back nav (settings/add/etc) on Android5 months agoc03f67121dd8vite.config.mobile.ts: define __PEACH_E2E_PASSKEYS__ = false. Without it passkey.ts threw ReferenceError at module init, blocking the dynamic import of background/messages and leaving the chrome shim's _handler null5 months ago96f9b36fbbafpopup/index.tsx: import and call setupMessageHandler on native — Android has no MV3 service worker so the popup itself owns message routing; without this the chrome shim's _handler stayed null and every sendMessage timed out as SERVICE_WORKER_UNAVAILABLE5 months ago1febc9d6daf1RecoveryWordDisplay: route save through navigator.share on native (Capacitor WebView ignores <a download>); button label flips to 'share recovery words' on mobile; desktop keeps <a download> fallback5 months ago2ce7d020ae13add biometricsEnabled to VaultSettings type5 months ago800fef2eb834add BIOMETRICS section in Settings security panel: enable/disable toggle wired to GET_DERIVED_KEY -> KeystorePlugin.storeMasterKey/clearMasterKey + biometricsEnabled UPDATE_SETTINGS; only renders on native + supported devices5 months agoa1d75b982320add biometric unlock path to LockView: hasMasterKey + isAvailable check on mount, auto-prompt 400ms after, BiometricPlugin.authenticate -> KeystorePlugin.retrieveMasterKey -> UNLOCK_WITH_KEY; biometric button rendered when available; biometric_key_invalidated falls back to password and clears biometricsEnabled5 months ago3872f604f17dadd shared/native.ts (isNativePlatform, nativePlugin); App.tsx subscribes to Capacitor App appStateChange and locks vault when background elapsed >= autoLockMinutes5 months ago16db45928fa3register __peachRegisterMessageHandler in setupMessageHandler so chrome shim can route sendMessage on Android; implement publishInMemoryVault and clearInMemoryVault via Capacitor.Plugins.InMemoryVaultPlugin; call from UNLOCK and LOCK5 months agoce27a78ad3c7before mobile bridge wiring (handler reg, autolock, biometric)5 months agod07b72217b9dharden recovery confirm against full browser restart: peach_recovery_pending moves to chrome.storage.local; handleUnlock checks flag after fresh password unlock and re-routes to recovery surface; LockView Match accepts forceRecoveryWords override (v2.35.1)5 months ago56ac0e7edbd8prevent vault auto-lock and lock-on-close while user is mid-recovery-confirmation: peach_recovery_pending session flag, set on CREATE_VAULT, cleared on confirm; popup re-route to recovery display via forceRecoveryWords; alarms tests await async listeners (v2.35.0)5 months agoc24f786299c5recovery word display: Arabic numerals (right-aligned tabular), download .txt button, layout fills surface; csv button text + accent button contrast/weight; peachscript placeholder shortened (v2.35.0)5 months agoa8f9afdd5aa7remove all Mayan code (encoder, decoder, RS, peachQR, restore tab, export panel, CSS); free up mobile→desktop transfer (drop Pro gate on START_PAIRING_SERVER and ACCEPT_PAIRING); convert remaining SW dynamic imports to static so vite preload helper never fires off-document; restore screen no longer pops out to a detached window; onboarding back button on cards 2-3; refine Two keys copy to acknowledge password reset via recovery words; Pro list now mentions advanced vault health (v2.34.0)5 months ago7d40cd620602convert recovery-words dynamic imports to static in vault.ts and messages.ts — SW has no document for vite preload helper (v2.33.7)5 months agoe774d43ad6dedrop mobile from Pro feature list — mobile is free (v2.33.6)5 months agocbd07363a87aupdate One rule -> Two keys card and create-vault warning to reflect recovery words backup path (v2.33.5)5 months agobaaa5658dee6fix data loss in +add migration: source migration patch from saved entry value not draft; only commit drafts that are non-empty and changed (v2.33.4)5 months ago4c8f4b2cdb09fix +add username race: only reset edit state on actual entry id change, not on same-entry refresh after onFieldSaved (v2.33.3)5 months ago6ea3c83640b8split identity into username + email blocks; +add button label and click handler match field semantics; legacy email-shape username migrates to entry.email when adding a separate username (v2.33.2)5 months ago0e1121ba9dd4bump manifest version to v2.33.15 months ago5c89a5298422conditional label: +add email/username flips based on what exists (v2.33.1)5 months ago9918ef3154edrevert email to conditional +add inside username edit mode (v2.33.1)5 months ago617375e08945entry view: show only set identity fields; +add email/username appears inside edit mode only, label flips based on what exists5 months agoee903becfbb0recovery screen: remove wordmark, rune mask top/bottom bands, visible input lines, button pinned to bottom5 months agoe67430a671b1v2.33.05 months ago
details
Peach
A free, open source, local-first password manager for Chrome, Firefox, and Android.
Peach encrypts your vault on your device. No hosted vault, subscription, or account is required to use it.
Features
- Passwords, cards, and secure notes — keep your private data together in one encrypted vault
- Inline autofill — fill and save credentials without leaving the page
- TOTP built in — generate two-factor codes without a separate authenticator
- Password health — find weak, reused, and exposed passwords
- Portable backups — export and restore with PeachScript or a
.peachfile
Peach Pro adds:
- Peach Sync — end-to-end encrypted sync across paired devices
- Passkeys — save and use passkeys in Chrome and Firefox
- Peach Codex — print an encrypted, scannable backup of your vault
- Advanced vault health, Canary Entries, and duress tools
See the Peach website for current availability and Pro details.
Install
Open Source
Peach is released under the GPL v3. This repository contains Peach's Chrome and Firefox browser extensions. Android is maintained separately.
The source is hosted on Kepr, Asha Software's version control platform.
Security
Vault data is encrypted with AES-256-GCM and protected by Argon2id key derivation. Peach Sync authenticates paired devices and encrypts data in transit.
Implementation details live alongside the code:
Building
bun install --frozen-lockfile
bun run build
Builds are written to dist-chrome/ and dist-firefox/.
Built by Asha Software · [email protected]