peach-browser
A free, open source, local-first password manager for Chrome, Firefox, and Android.
TypeScript
timeline
atlas285 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.tsClipboard write + reliable auto-clear — audit fix HV-2.codex-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.lock-port.test.tsLV-5: the lock-on-close onConnect listener accepts only our popup port (legacy bare "popup" or nonce'd "popup-<uuid>") and ignores anything else.entry.tshealth.test.tshealth.tshealth.ts — Pro advanced vault health analysis.license.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.tsoffscreen.htmloffscreen.tsOffscreen document script — audit fix HV-2c.paired-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.tspending-vouched-devices.tsPending vouched devices — audit fix MV-7.recovery-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-alerts.tsPending sync alerts — audit fix HV-1b.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.sync-clamp.test.tsUnit tests for HV-1 — sync timestamp clamp + remote-mutation alerts.vault.test.tsvault.tsvault.ts — sole owner of vault state and chrome.storage vault keys.content/
passkey-toast/
crypto/
argon2.test.tsargon2.tscrypto.test.tsdecompression-bomb.test.tsMV-4: decompression-bomb output bounds on the zstd and pako legs.peachPayload.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-search.test.tsvault-search.tsVault.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.homograph.test.tsLV-2: homograph detector tests.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-limits.tsImport-path resource bounds — audit fixes MV-4 (decompression bomb) and MV-5 (unbounded file/string allocation).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-limits.tsSync trust + resource bounds — audit fixes HV-1 (timestamp clamp) and MV-3 (receive-path size bounds).sync-types.tsChirp Sync — type definitions (Master Brief v2).types.tstypes.ts — cross-boundary types and the MessageType union.tests/
fixtures/
.wasm blobs that have not been byte-verified against a reproducible build:history
b375e5f9a3earecovery word grid: 3-col → 2-col, min-width:0 on inputs, align-items:stretch on container, overflow-x:hidden5 months agod389c9f486fbfix forgot-password button: move recovery word entry match before hasVault match so it isn't shadowed5 months ago808ea0e592b9v2.32.0 — sync Firefox to Chrome version5 months ago8a823f06122bbroaden policy scraper: deeper DOM walk, label/div selectors, range/exact/min-only pattern forms, between/exactly text phrases5 months agod08bf4e3dd8aadd email field to entries; smart email/username label; +Add Email button; inline popup label fix5 months ago3640600d7a5cbefore email field and identity label changes5 months ago952ee75b2c6eshow fresh recovery words in Settings after password change5 months ago62761aef1e41fix BIP39 byte extraction and rotate root key on password change5 months ago9a7231c2c15eadd RecoveryWordDisplay view (one-time show after create) and pre-v2.12 migration path5 months ago85a75322611cadd recovery word entry UI and RecoveryRuneBackground5 months ago7efc46dd7ed8add recovery message handlers: VALIDATE_RECOVERY_WORDS, GET_RECOVERY_WORDS, RECOVER_WITH_WORDS5 months agobc7ce39e8e32add root key generation and recovery word wrapping in vault.ts5 months ago0f4c072b3db1add recovery word list and BIP39 encoding utilities5 months ago13906d7cd444before recovery word system save5 months ago46eb00d0cb2fbump manifest version to 2.30.2 (v2.30.1 was set before this session)5 months agoe5574b086b37add mobile build to ci.ts: build:mobile step after Firefox5 months agodb528eefa8a6add build:mobile script to package.json and create vite.config.mobile.ts for Android/iOS WebView bundle5 months ago4ec3741cd316add mobile message handlers to messages.ts: UNLOCK_WITH_KEY, GET_DERIVED_KEY, SCAN_PAIRING_QR, GET_LOCAL_IP, START_PAIRING_SERVER, TRIGGER_SYNC, GET_IDENTITY_SUGGESTIONS, POPULATE_INLINE_VAULT5 months ago817f71790ba4add vault.ts unlockWithKey (bypass Argon2id, use pre-derived key) and getDerivedKeyHex5 months ago567532481e30add mobile message types to MessageType union: UNLOCK_WITH_KEY, GET_DERIVED_KEY, SCAN_PAIRING_QR, GET_LOCAL_IP, GET_IDENTITY_SUGGESTIONS, POPULATE_INLINE_VAULT5 months ago231409f05d0abefore mobile message types and build config5 months ago50d4e457800fadd scripts/ci.ts — bun CI runner for typecheck, tests, chrome and firefox builds5 months agocc7196b4e72abump to v2.30.1, rebuild chrome and firefox5 months ago7767a36970cdpeach-browser clean — android, native sync host, and mobile-only dead code removed (v2.30.0)5 months ago1882919c9260remove all Android/Capacitor code, native sync host, and mobile-only dead code — browser extension only (v2.30.0)5 months agocba62ca5b081remove all Android/Capacitor code from popup views — App, Settings, Lock, SyncPairing, Onboarding5 months ago31184beaf504sync.ts and sync-lifecycle.ts removed — all importers fixed5 months agoeae5d6dc3a8bandroid/, native/, mobile scripts, and nativeMessaging permission removed5 months agob48bbea6d7efbefore cleanup — removing android and dead code5 months agoe0ec1767f8ccv2.29.3 clean baseline — before android implementation spec6 months ago71bd41b42835v2.29.3 audit complete — clean baseline confirmed6 months ago3cab4edce2f2before android master spec v2 full implementation6 months ago964f286213ccsilver platter + button, freeze popup width at init, nowrap action buttons (v2.29.3)6 months agoce749ba3a1e9clean extension baseline — pre-android restart6 months agoa91c0ac7e2f6Advanced toggle changes to − Advanced when expanded so it can be collapsed (v2.29.2)6 months ago77495c3a8024create-form grid overflow fixed — minmax(0, 1fr) on create-body and f-group tracks (v2.29.1)6 months ago084ea5aa4cd2inline popup: + button, always-show 2FA tray, cap width at 400px (v2.29.0)6 months agoa1ec5abcd016canary and passkey collapsed under + Advanced toggle in entry view (v2.28.0)6 months agob3757502a1b3pro upgrade UI — no sync hero icon, no color-mix drop-shadow on mark, narrow CTA buttons (v2.27.2)6 months agof0787b007df5breach status clears immediately on password change — optimistic clear before async HIBP check (v2.27.1)6 months ago9578774143bfpre-pluck baseline — android build cache and dist-mobile removed (regeneratable)6 months ago4f6535d225c9before native Peach autofill bottom sheet (PeachFillActivity)6 months ago0dea80b147f3fix settings crash (getManifest shim), replace peach emoji with PeachMark SVG in bloom canvas / ProCelebration / pairing banner (v2.27.0)6 months ago2ac38e92f4debefore settings fix + emoji-to-PeachMark replacements (v2.27.0)6 months ago136af2969805mobile gestures: swipe-up → vault list, swipe-L/R → navigate, wordmark → settings, gesture welcome card (v2.26.0)6 months ago7d83d974d418android: Kotlin plugin + lifecycle-ktx deps + peach launcher icons + PEACH_E2E_PASSKEYS mobile define6 months ago3673ad98ff49feat(mayan): v2 — corner anchors, homography decoder, RS(255,204), v1 dropped (v2.25.0)6 months ago47945ca845b0before mayan v2 rewrite — corner anchors, homography, RS(255,204)6 months agoa01510e32b46wip: pre-v2 — added 5KB and 20KB image-pipeline round-trip tests6 months ago36d1d3899c98fix Mayan image-decode failure: rune scan was eating data dark blobs adjacent to rune left vertex; switched findOthalan to sliding-window peek + multi-row averaging6 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]