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
2f6adfd23117move Destroy vault out of Settings home and into Settings → Vault below the Replace vault row, where the other irreversible vault operations live; bump v2.11.76 months ago08214da8ecc2redraw extension icon: drop the dark rounded-square wrapper that was swallowing detail at 16px, peach + leaf now fill the icon canvas; bump v2.11.66 months agoc520b474a1f3spec-align .peach: filename peach-backup-YYYY-MM-DD.peach (date-only), CSV/file picker accepts .peach + isPeachScript-content sniff, FileImport routes .peach to PeachScript subview via prefill, bump v2.11.56 months agof6e79034f2cdadd Download .peach button to PeachScript export, accept .peach file in PeachScript import (works in both merge and replace modes since Lock-screen restore uses the same view), bump v2.11.46 months ago6dd10798c332flatten nested glass borders across settings views: rune canvas, script input, settings inputs, feedback textarea now use translucent inset fill instead of double borders inside the glass card; bump v2.11.36 months ago6ff9bfed174fmerge passkey-only entries into matching login entries on read (consolidates duplicates from pre-v2.11 registrations); fix isPasskeyOnly to check password not username; permit empty-password updates on logins that have a passkey attached; bump v2.11.26 months agod5f614d9f6b0filter passkey-only + notes from inline autofill selector, add passkey badge to entries with both password and passkey, move tags section above TOTP so it stays discoverable when 2FA is present, bump v2.11.16 months agoca652c13429fbump v2.11.0, Projects.md §3.10 rewritten for new architecture, session notes ship outcome6 months agod8f1032bb523Entry.tsx adds passkey section + gates login fields for passkey-only, App.tsx routes all entries through EntryView, popup Vault/Health/Export/Import use entry.passkey, delete unused PasskeyEntryView + PasskeyEntry interface6 months agodf243b15db9dpasskey.ts: attach passkey to existing login entry at same domain (or create new login entry); read/write via entry.passkey sub-object; flip GET_PASSKEYS / GET_PASSKEY_FOR_DOMAIN to new shape6 months agocad47b22243cvault read-migrate type=passkey + flat fields to type=login + passkey sub-object, persist on next save, update sanitize/dupe key/messages handlers6 months ago85dda211aed3add PasskeyData sub-object + entry.passkey field to VaultEntry, hasPasskey/isPasskeyOnly helpers, keep flat fields as deprecated for migration6 months agoa86e59d61c04before passkey-as-subobject unification (Path B, v2.11.0)6 months agod3b325e8e06dshow tag chips on passkey entry view to match login entry pattern, bump v2.10.56 months agoc24fc253fd97move passkey delete to trash icon next to title (matches login entry pattern), remove buried bottom button, bump v2.10.46 months agocdb8aed8a54aadd diagnostic log for passkey get assertions to surface any handler-side issues6 months ago4823bacb5348fix ES256 passkey signature DER encoding so RPs accept assertions, suppress redundant State 11 banner on Chrome same-browser entries, dedupe State 11 across navigations via session storage, bump v2.10.36 months ago886a0cd205b0fix vault getRandomValues entropy overflow on >64KB vaults, defensive entries reload + celebration replay on license activation, tighten passkey approval card layout, bump v2.10.26 months ago0527a541c2cfadd Firefox 150+ popup credential flow, inline States 11+12, cross-browser banner, decline storage, bump v2.10.16 months ago4309fdecba8dbump to v2.10.0, add passkey + panic invariants to Projects.md, log to session notes6 months agoedc59d2b2a37add Firefox MAIN-world passkey detector + manifest content_scripts entry6 months ago698feaf6f97cadd Panic three-step flow, DESTROY_VAULT handler, Settings danger zone, panic CSS6 months ago3e34a4a87aa1add browser + transports fields to PasskeyEntry, export detectBrowser, tag chrome creates6 months ago6b53ab782017before passkeys cross-browser + vault panic (v2.10.0)6 months ago6152c18a0700bump to v2.9.16 months ago31a6f1479013pro upgrade page layout — key entry always visible, tighter hero and features6 months agob773702b0bf3bump to v2.9.06 months ago9bf731ef9119pro screen redesign, canary in security, trash polish, account nav label6 months agofba638254319fix license activation — remove toUpperCase, error above button, centered error style6 months ago5e086a0d6860rotate Ed25519 signing key — new keypair, public key updated in license.ts6 months ago2b750981a679fix rune glow transition — zero text-shadow base so accent color interpolates smoothly6 months ago371604b7dc54center rune string in empty space — flex: 1 spacer between hero and panel6 months agoa0ab75fd9e93lock screen rune string — static 9-char span row, occasional single glow, between hero and panel6 months agod109a2559fe3slow rune particles — gentle gravity, slow drift, long fade-in for passive magic feel6 months ago8a31f36f18f1lock rune canvas — particle funnel effect, runes drawn toward password input6 months ago3cd2c71bbf8dfix light theme and rune density — transparent canvas, 8% density, theme-aware idle color6 months ago7581d519f206fix lock rune canvas — cyclic string scroll matching onboarding mechanic, 30% density6 months ago26c99f63f576settings glass surface — backdrop blur groups with warm accent gradient background6 months ago2d677f90e079lock screen rune background — sparse slow canvas behind unlock form with glass panel6 months agoce3d87b6878cbefore lock screen runes and settings glass surface6 months ago450e326d3f5cadd light backdrop-filter blur under onboarding and new-vault cards for text readability over runes (v2.8.3)6 months agobe2a58d2eba5space rune background out — 60% fewer visible runes, opacity restored to 0.07 (v2.8.2)6 months agoc18389e80430drop onboarding rune opacity 60% and rework new vault screen to share onboarding card visual language (v2.8.1)6 months ago80afc813ba15rebuild dist-firefox to keep it in sync with v2.8.06 months ago9b947c544f7cbump version to 2.8.0 — first-run onboarding feature6 months ago177541d96a99gate Onboarding view ahead of NewVault on first install via peach_onboarded storage flag6 months agoaa954418fa8fadd onboarding card, dot, and rune-background styles with entrance animations6 months agoa4900d4d1c92add Onboarding view with three-card welcome flow6 months agoe056e5981747add RuneBackground component for atmospheric rune drift behind onboarding6 months agoe7cf01cbd96cbefore first-run onboarding implementation6 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]