peach-browser
A free, open source, local-first password manager for Chrome, Firefox, and Android.
TypeScript
timeline
atlas290 files
public/
codex/
fonts/
models/
scripts/
build-peachscript.pyBuild PeachScript-Regular.otf — 256 historical-runic glyphs.ci.tsclean-chrome-dist.mjsclean-firefox-artifacts.mjsgenerate-kat.mjsgenerate-kat.mjs — recompute the pinned ciphertext for self-test.ts (PCH-01-020).package-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.test.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.session-escrow.test.tsvault.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.test.tstotp.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.clamp.test.tspdf-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.tsxzxcvbn-strength.test.tsLV-8: the @zxcvbn-ts replacement must score the master-password strength meter on the same 0-4 scale as the old zxcvbn, with dictionaries loaded (language-common is what keeps weak passwords from scoring optimistically).shared/
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
5e5b58af45b5receiver auto-accepts the SAS in inverse pairing: both sides derive it from the same Noise handshake hash, so the codes match by construction. Receiver returns true from confirmSas immediately, drops the ADOPTION_SOURCE_SAS push, removes the popup's SAS phase and the RECEIVER_SAS_DECISION round-trip. Phone's 'They match' is the single user gate. Deleted waitForSasConfirmation, resolveReceiverSasConfirmation, the pendingSasConfirmation slot, and the receiver timeout. Updated test fixtures to match. (v4.3.15)3 months ago588994063c7freceiver session was swallowing the real error in its catch block. Log the actual exception via console.error and surface the message in the ADOPTION_SOURCE_RESULT push so the popup shows the real failure instead of the generic 'adoption_failed'. Bump to v4.3.15 to actually publish the logging change. (v4.3.15)3 months ago55d8aadfbe09receiver session was swallowing the real error in its catch block. Log the actual exception via console.error and surface the message in the ADOPTION_SOURCE_RESULT push so the popup shows the real failure instead of the generic 'adoption_failed'. (v4.3.16)3 months agoe97b03ea682asource flow SAS gate: START_ADOPTION_SOURCE now actually waits for the popup to confirm the 8-digit code instead of auto-approving. Mirrors the receiver's id-keyed deferred pattern (SOURCE_SAS_DECISION). Both pairing flows now have symmetric, real SAS gates. (v4.3.15)3 months agoecedb447300fPairingBirds were overlapping on the 'Add a new device' screen — 220px stage held two 108px birds at 28px inset (52px overlap). Widened the stage to 300px and moved the birds in to left/right 12px so they sit ~60px apart. (v4.3.14)3 months agoa4750a51db3cbrowser receiver loop: START_ADOPTION_RECEIVER now accepts the phone's Noise dial, receives ADOPT_GRANT, calls CREATE_VAULT_FROM_ROOT_KEY with the popup-supplied password, and pushes ADOPTION_SOURCE_RESULT. SAS confirmation goes through a new RECEIVER_SAS_DECISION message: the popup confirms via the same chrome.runtime.onMessage pipe the existing source flow already uses. AdoptVaultView re-adds the sas/success/error phases it dropped in the earlier simplification. Source-side requestConsent left as-is (TODO in task brief; touching it would change the existing source-flow test expectations). (v4.3.14)3 months ago146d23dcd148invitation carries vaultStatus: 'empty' for the onboarding receiver (no vault) and 'populated' for the Sync settings source (has vault). The phone reads this to decide its role — source or receiver — instead of guessing. Older invitations without the field parse as 'populated' (the historical default) so the existing sync is unaffected. (v4.3.13)3 months agof65d67bbb5baonboarding: reverse the QR flow. The empty extension now shows a QR (the phone scans it) instead of scanning the phone's QR. New START_ADOPTION_RECEIVER message in the background holds the rendezvous without needing a vault, and AdoptVaultView displays the result. UI-only — the phone-side reversal (sending the vault back over the existing channel) is a separate change. (v4.3.12)3 months agoee7c66358190restore the Sync settings birds: the onboarding testicle-look was the only complaint. Restored PairingBirds.tsx, the birdStage function in PairDevice.tsx, the test assertion, and the bird CSS block. (v4.3.11)3 months ago3f5891a8b076onboarding cleanup: drop the bird-pair avatars from AdoptVaultView (pair and success phases) and PairDevice — the two circles on a bar looked like testicles. Trashed PairingBirds.tsx, removed its first CSS block. Drop the 'Already have a backup?' section from Lock.tsx — the welcome screen already asks, and the test for it. (v4.3.10)3 months ago58c7a0bdb8f3notes mode: move new-note affordance from the bottom of the list to the header bar as a + glyph, so a long note list no longer hides the button below the fold (v4.3.9)3 months ago52793d6ded0asettings card scrollbar: pull the body out of the card's right padding so the thumb sits flush with the right edge, and add a matching thin Webkit scrollbar style for Chrome (v4.3.8)3 months ago52ea861750a0Entry view: notes are no longer in its navigation set, counter, or default-selection path; single nonNoteEntries memo and pickNavigable helper make the invariant hold at every fallback (v4.3.7)3 months ago3453e4d02417vault list: long-press now enters multi-select with the held row selected, and the synthesised mobile contextmenu event is suppressed so it doesn't reopen the menu and undo the gesture (v4.3.6)3 months ago88f4c97bcaabtreat a peer-closed WebSocket after entry exchange as a completed sync, not run_failed; classify mid-protocol disconnects as connection_lost (yellow) so the indicator stops turning red on syncs that demonstrably landed (v4.3.5)3 months agoaee880956950fix: Move Sync now to global status (v4.3.4)3 months agoccb6a770acb0fix: Let vault presence direct pairing (v4.3.3)3 months ago3b8b0dd8f317feat: Keep routine sync quiet (v4.3.2)3 months agoc700871e2778feat: Clean up existing-user Sync onboarding (v4.3.1)3 months agodaf6d2a04ad2feat: Simplify Sync Settings with progressive disclosure (v4.3.0)3 months ago399fb468341bfeat: Make pairing single-confirm and atomic (v4.2.18)3 months ago425e41d0ec00docs: Record first live Peach Sync completion3 months agoa7989ee758fefix: Correct large sync frame chunking (v4.2.17)3 months ago5b989b3f66e2fix: Preserve sync timeout stage (v4.2.16)3 months agoc6bed9d2aebedocs: Queue calmer Sync Settings structure3 months ago27e2e647a814fix: Reconcile paired-device revocations on startup (v4.2.15)3 months ago9faf99d62ad3fix: Repair stale paired-device removal (v4.2.14)\n\n- Remove overlapping paired rows even when a terminal revocation already exists\n- Clear old revocations after a fresh SAS-confirmed direct re-pair\n- Add regressions for both live-state shapes3 months agof1785b58565aadd unpair regression: storage revoke + UI refresh — message handler and Settings test3 months agofee1c9e1e62eadd chrome.alarms periodic sync, SW startup hook, and device-list-change trigger; reclassify network-class outcomes from error (red) to warn (yellow); bump to v4.2.133 months ago0f40221cf386fix the v4.2.11 chunking bug: a non-last chunk sliced at MAX then prepended a marker produced 65520-byte plaintexts the crypto core refused, so multi-chunk frames crashed. Now slices at MAX-1 to leave room, and a real-Noise round-trip test pins the invariant (v4.2.12)3 months ago0b24e17342fdfix the broken sync: split a too-large padded frame across Noise messages, mark the first with a continuation byte; padded frame stays 24 MiB, single-chunk path unchanged, and the bucket ladder is now provably under the 65519-byte Noise plaintext limit (v4.2.11)3 months ago4ab2a08223f8search and vault-security match the real UI: escape closes the list rather than clearing it, the filtered-empty list has its own copy, the generator opens from the list, CSP is asserted on the manifest, and four vendor-bundle greps that only ever matched pdf.js and a QR library are gone3 months agof963b19a27a4createEntryViaForm reveals the 2FA and notes fields through their '+ add' links, which is the only way those inputs exist in the new-entry form3 months agocb6120398385vault-security: the XSS checks asserted the escaped payload was absent from rendered text, which fails on correct escaping — assert instead that no script element, img or inline handler is ever created, and that GET_ENTRIES answers vault_locked once locked3 months agobd082b4a23c5playwright: point the specs at the list overlay — the top search bar is readOnly and only opens the list, so filling it or clicking new-entry from the vault stage could never work3 months agocce5d8227d4eextract the working vault setup into tests/helpers/vault.ts, which asserts it reached the unlocked vault instead of skipping creation silently; port lock-screen, entry-crud, settings, search, vault-security and vault-lifecycle onto it and drop the three assertion-free specs3 months ago9378234431eesync indicator light (pulsing green syncing / solid green healthy / red problem) plus persistent last-attempt reason in Settings and the topbar sync button (v4.2.10)3 months agode6976b06e68every terminating sync path reports a named SyncOutcome with device inventory, persisted last attempt, and [Peach sync] service-worker logs3 months ago7e3d43b00009match device revocation on the revoked long-term key, not just the self-asserted deviceId, so a revoked device cannot return under a fresh id (v4.2.9)3 months ago602463675e06record that the old feedback key had no account behind it, so a 200 success was never evidence of delivery, and narrow B5 to June confirming the test email arrived3 months ago89e76b54a2b7point feedback at the Web3Forms account that actually exists — the previous key was never set up, which is why every submission was accepted and nothing was ever delivered (v4.2.8)3 months ago70f1095eb4c1rewrite the consolidated queue around what actually blocks sync, and record the feedback diagnosis, the website rewrite, and the kapt trick that finds an unattributed Kotlin error3 months ago478a839aacaedelete the SUBMIT_FEEDBACK handler that returned ok while sending nothing, and the 261 lines of pairing-code CSS no component has referenced since the code-entry surface was removed (v4.2.7)3 months agoc8a0fc89e74dcorrect the feedback queue item: the extension's Web3Forms path works, only Android has no endpoint, and the SUBMIT_FEEDBACK handler returns ok while sending nothing3 months ago9369069f7f73record the settings-UX and relay-surfacing session, the adoption relabelling bug the fail-closed gate exposed, the adopt-screen deviation and why, and queue the feedback-backend worker without its credentials3 months ago26cd2586ed62stop the flex column stealing the bird stage's height to fit what is below it, and pay for the two new rows on the invitation screen by moving what the code contains onto the text view where the string is actually visible (v4.2.6)3 months agoc626a5aa8656put 'Show a code instead' under the QR: the same invitation as selectable text with a copy button, for a camera that will not focus (v4.2.5)3 months ago25d58a4fe204surface the relay choice on the invitation screen as a quiet change link that rebuilds the code, and say plainly on the adopt screen that the scanned code carries the relay rather than offering a choice it would overwrite (v4.2.4)3 months ago2fdc9c8169eaextract the three-state relay choice into one SyncModeSelector so Settings and the pairing surfaces cannot drift: exact disclosure line, radio-group semantics, and an empty private URL field that says sync is paused instead of quietly using the public relay (v4.2.3)3 months agoa5b058442cd7fail closed when Private relay is chosen with no URL: one relayInForce gate for sync and pairing, and stop pushing the public relay to peers under a private label (v4.2.2)3 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]