peach-android
A free, open source, local-first password manager for Android.
Kotlin
timeline
atlas365 files
app/
drafts/
MF1MF2/
BROWSER-SPEC.mdExtracted from
peach-browser source (read-only; never modified).ExportRoundTripTest.ktgen_peach_fixture.mjsImportParsersTest.ktImportScreen.kt───────────────────────────────────────────────────────────────────────────── ViewModel ─────────────────────────────────────────────────────────────────────────────mf1_kat_gen.mjsGenerates an MF-1 known-answer vector using the BROWSER's exact recovery algorithm (recovery-words.ts) against the REAL browser word list.parse_android_export.mjsPeachPayloadCodec.ktPeachScript binary payload (PCHS) — a byte-for-byte port of the browser's peachPayload.ts (MF-2).PeachScript.ktPeachScript outer codec — maps each payload byte to one Private-Use-Area code point in U+E000..U+E0FF, and back.PeachScriptExport.ktPeachScript export (MF-2) — writes the browser's PCHS binary payload (Argon2id + AES-256-GCM, zstd sections, BLAKE3 checksum, size-bucket padding, string-table entry packing) re-encoded into Private-Use-Area text.PeachScriptImport.ktPeachScript import (MF-2) — parses the browser's PCHS binary payload back into full vault entries.PeachScriptTest.ktRecoveryEscrowTest.ktRecoveryWords.ktVaultCrypto.ktVaultRepository.ktVaultStore.ktOne encrypted slot at rest.src/
androidTest/
java/
debug/
res/
values/
main/
java/
com/
peachpasswords/
autofill/
AssistStructureParser.ktThe autofillable fields discovered in one [AssistStructure], plus the origin (web domain for browsers, package name otherwise) used to rank vault entries.AutofillEnablement.ktWhether Peach is actually the system's autofill service, and the one-time offer to make it so.AutofillEntryPickerActivity.ktBranded bottom sheet shown when the user taps "Search Peach…"/"Unlock Peach" in the system autofill drop-down.AutofillIntents.ktPendingIntents the autofill surfaces hand to the framework: a no-op attribution target the inline chip requires, the authentication IntentSender that opens the branded [AutofillEntryPickerActivity], and the "open new entry" launcher that the picker fires when the user taps the "+ Create new entry" affordance.AutofillNavRepository.ktCarries a one-shot "open the new-entry editor" request from the autofill picker to the nav host.AutofillNavViewModel.ktThin Compose-friendly wrapper around [AutofillNavRepository] so the NavHost can grab the singleton via
hiltViewModel() without reaching for an EntryPoint accessor.AutofillResponseBuilder.ktTurns parsed form fields + vault entries into autofill [Dataset]s — the menu RemoteViews row, the inline keyboard chip, and the actual field values.AutofillSave.ktPeachAutofillService.ktSystem autofill provider.TrustedBrowsers.ktConservative allowlist of apps permitted to request autofill for a web origin (MF-7).codex/
CodexAztec.ktAztec encode/decode for one Codex chunk, via ZXing.CodexAztecFrame.ktLive-camera Aztec decode for the Codex restore camera path (D10).CodexCodec.ktPure (Android-free) Codex byte pipeline: compress → stripe → Reed-Solomon → envelopes, and the inverse for restore.CodexGenerator.ktGeneration milestones surfaced to the UI.CodexPageLayout.ktA4 Codex page geometry — the exact port of the browser's
popup/codex/pdf-layout.ts, which is the canonical Codex page format.CodexPdf.ktRenders the Aztec codes onto an A4 PDF in a 6×6 grid — the printed Codex.CodexRestore.ktRestore side: render a Codex PDF back to bitmaps, crop the 6×6 grid using the same geometry [CodexPdf] laid down, decode each Aztec, then Reed-Solomon reconstruct the payload — surviving missing or unreadable codes up to the parity budget.CodexTypes.ktCodex on-paper format constants and shapes — port of the browser shared/codex-types.ts.ReedSolomon.ktSystematic Reed-Solomon erasure codec over GF(2⁸), Backblaze/JavaReedSolomon construction (Vandermonde matrix made systematic).di/
feedback/
haptics/
passkeys/
shared/
sync/
BackgroundSyncCoordinator.ktOwns the "when do we actually start the sync service?" decision for the background-sync preference.BackgroundSyncPreference.ktBatteryExemption.ktAsks once to be left out of Doze / App Standby.CloudRelayDialer.ktOne relayed reconnect session where WE speak first — the mirror of [runCloudRelayResponderSession], and the half Android never had.CloudRelayReconnectListener.ktCryptoCompare.ktFixed-format protocol comparisons.DeviceIdentity.ktThe persisted keys keep their original names on purpose.DeviceManifestSupport.kt0x02 added the
revoked array to the signed body.DeviceType.ktWhat kind of device a peer is, on the wire and in the paired-device store.ForegroundSyncCoordinator.ktNoiseKK.ktNoiseNK.ktPairedDevice.ktPairedDeviceStore.ktPersistent registry of paired devices, encrypted at rest with EncryptedSharedPreferences (same construction as DuressConfigStore / LicenseRepository, v2.1.36).PairIdentityFrames.ktThe PAIR_IDENTITY frame: who a peer claims to be, exchanged inside the encrypted session once and pinned thereafter.PairingAuth.ktPairingFrames.ktLength-delimited frame IO for a pairing/sync connection.PairingInvitation.ktPairingSession.ktThe user's SAS decision, handed to the UI and awaited by the live pairing session.PeachSyncService.ktKeeps this device reachable on the relay so an already-paired peer can reconnect.PeachWebSocket.ktA minimal RFC 6455 server endpoint — just enough of the protocol to talk to a browser extension's new WebSocket(...).PendingVouchedDeviceStore.ktRelayAdoptionHost.ktRelayAdoptionReceiver.ktReceiver half of relay-first vault adoption.RelaySettingsStore.ktSync is exactly three named choices (docs/sync-lan-retirement.md, mirroring the browser's sync-settings.ts):Rendezvous.ktRustNoiseNative.ktThin JNI boundary over the canonical Rust snow state machine.SASDerivation.ktSyncAlert.ktSyncAlertStore.ktSyncCoordinator.ktSync — Phase 2 manifest-diff coordinator.SyncFrameTransport.ktE7b: split a too-large padded sync frame across multiple Noise transport messages and reassemble it on the other side.SyncFreshStartResetter.ktClears every piece of state that can make a destroyed vault still look paired.SyncIdentity.ktSyncLimits.ktCloudflare Workers caps one WebSocket message at 32 MiB.SyncMessage.ktSync wire protocol — exact port of the browser SyncMessage union (shared/sync-types.ts).SyncOutcomeReason.ktWhy a sync attempt ended, in the same vocabulary the browser uses (src/shared/sync-outcome.ts).SyncOutcomeStore.ktThe single place a sync attempt is allowed to end.SyncPadding.ktE7: frame padding at the relay boundary.SyncPeerRole.ktWho speaks first in a relay room.SyncSession.ktTransport-neutral session consumed by the sync coordinator.VaultAdopt.ktVault adoption frame protocol — exact port of the browser shared/vault-adopt.ts.VaultSyncAdapter.ktProduction [SyncVaultAdapter] backing the coordinator with the live [VaultRepository].ui/
codex/
components/
BirdAnimation.ktThe three acts of the pairing animation, bound to the audio protocol.CharEnterText.ktPer-character entrance: each glyph fades in and rises into place with a staggered delay.CopyButton.ktCopy button with the two-effect copy feedback (spec §4.4): a diagonal sheen sweeps once over ~600ms and an accent drain bar fills 0→100% over 1.4s.CopyFeedbackOverlay.ktFaviconInitials.ktInitials chip used in place of a network favicon (offline-first).LockRuneString.ktPairingBirds.ktThe two pairing birds, ported path-for-path from the browser extension's
PairDeviceFlow.tsx (a finch and a swallow) rather than redrawn by eye.PeachEmptyOrEndState.ktPeachExpandableCard.ktPeachField.ktPeachMark.ktThe Peach brand mark — a peach fruit with a single leaf.PeachSegmentedControl.ktPeachTopBar.ktQaFlags.ktDebug-only, opt-in escape hatch so automated visual QA (screenshot-based Gate 2 comparisons) can capture screens that are normally FLAG_SECURE-protected.RuneGridBackground.ktSecureFlagEffect.ktSets WindowManager.FLAG_SECURE while this composable is in the composition and clears it on dispose — blocking screenshots, screen recording, and the recents thumbnail of screens that display secrets (MN-3: recovery words, export blob, codex generation).SyncIndicatorDot.ktThe sync indicator light, shared by the vault list and the Sync settings card so the two can never disagree.TOTPRing.ktA small ring that sweeps once per TOTP period and turns breach-red in the final 5 seconds.lock/
BiometricKeyStore.ktStores the vault's AES key wrapped under a hardware-backed, biometric-gated Android KeyStore key, so the lock screen can unlock without the master password.Biometrics.ktThin wrapper over androidx BiometricPrompt for the re-auth gate.BiometricUnlockActivity.ktLockScreen.ktLockViewModel.kt
onboarding/
pairing/
AdoptVaultScreen.ktAdoptVaultViewModel.ktBackgroundSyncDialog.ktCodePairScreen.ktPair a device by code.CodePairViewModel.ktThe phone half of pairing: occupy a relay room, show the invitation, wait to be scanned.PairingQrCamera.ktPairingQrFrame.ktQR-only CameraX decoder for reachability invitations.PairingRelayChoice.kt
recovery/
security/
settings/
CardIcon.ktThe seven settings-card glyphs — exact ports of the browser CardIcon.tsx SVGs (viewBox 0 0 16 16, stroke 1.25, round caps/joins).PanicScreen.ktProCelebration.ktCSS cubic-bezier(0.16, 1, 0.3, 1) — the browser's bloom/wordmark-in easing (a pronounced ease-out-expo feel).SettingsCardBodies.ktSettingsScreen.ktDeck geometry — ported verbatim from StackDeck.tsx constants.SettingsStack.ktThe six settings categories, in deck order (Pro on top).SettingsViewModel.kt
theme/
AccentColors.ktPeachColors.ktPeachMotion.ktPeachPalette.ktA resolved set of Peach colour tokens.PeachRadius.ktPeachSpacing.ktShared 4dp-based spacing scale extracted from the lock-screen layout.PeachStackColors.ktPeachTheme.ktCurrent accent color, available to any composable under [PeachTheme].PeachType.ktShellBackground.ktThe two-bloom shell background that sits behind every screen.
vault/
AdditionalUrlsDetail.ktE3 — additional-URL rows for EntryDetailScreen.AdditionalUrlsEditor.ktE3 — hard cap on additional URLs, matching the spec.CardDetailFields.ktD2 — EntryDetail CARD display block.CardEditFields.ktD2 — EntryEdit CARD field block.CardFieldUtils.ktShared card formatting/detection helpers for D2 (card type fields).ContextMenuSheet.ktD12 long-press context menu (spec §9).CsvExport.ktPure-Kotlin CSV serialisation for the C2 Export screen (CSV sub-view).CsvImport.ktPure-Kotlin CSV / JSON import parsing for the Import screen (spec B2).DetailTagRow.ktInline tag row for EntryDetailScreen, mirroring the browser EntryView: chips display in place, and the "+" affordance expands a same-surface tag editor.EditableFieldRow.ktD6 — Inline per-field editing for EntryDetailScreen.EntryDetailGenerator.ktD4 drafts — generator access from EntryDetailScreen.EntryDetailScreen.ktEntryDetailViewModel.ktEntryEditScreen.ktEntryEditViewModel.ktExportScreen.kt───────────────────────────────────────────────────────────────────────────── Password strength scorer (local, dependency-free) ─────────────────────────────────────────────────────────────────────────────IdentitySuggestDropdown.ktAnchored suggestion dropdown for identity-style fields (username/email).ImportScreen.kt───────────────────────────────────────────────────────────────────────────── ViewModel ─────────────────────────────────────────────────────────────────────────────MultiSelectUi.ktD12 multi-select per-row checkbox (spec §9).NoteHtml.ktNote bodies are authored in the browser's contenteditable, so a synced note arrives as HTML: the extension's sanitizer allow-list (NoteEditor.tsx) is b, strong, i, em, u, s, h2, h3, ul, ol, li, br, hr, p — attribute-less — plus the div wrappers Chrome's contenteditable inserts for new lines.NotesModeScreen.ktE2 — full-screen editor for NOTE-type entries.NotesModeViewModel.ktBacks [NotesModeScreen].PasswordHistorySection.ktShared past-password history UI, extracted from EntryEditScreen so both the editor and EntryDetailScreen render the same rows.PeachField.ktThe Peach text field used across the entry-edit screens: a bare underline (no border box), drawn in t3 and lit to the accent while focused — matching the lock screen's credential inputs.PeachScriptExport.ktPeachScript export (MF-2) — writes the browser's PCHS binary payload (Argon2id + AES-256-GCM, zstd sections, BLAKE3 checksum, size-bucket padding, string-table entry packing) re-encoded into Private-Use-Area text.PeachScriptImport.ktPeachScript import (MF-2) — parses the browser's PCHS binary payload back into full vault entries.RecoveryWordsScreen.ktRuneResolve.ktWhich leg of the restore animation is running (browser: RestoreSymbols'
animating).TagChipEditor.ktMax tags per entry.TagListWidgets.ktHorizontally scrollable tag filter strip for VaultListScreen, placed between the search bar and the sort bar.TotpInlineEdit.ktE6 — TOTP double-tap to edit the 2FA secret, inline in EntryDetailScreen.TrashScreen.ktVaultHealthScreen.ktWarm amber used for the "reused" and "weak" advisory buckets.VaultListScreen.ktVaultListViewModel.ktupdates/
UpdateCheckWorker.ktLaunch extra set by the update notification so the app opens on the update flow.UpdateManifest.ktKepr's generic release manifest, as returned by
GET https://kepr.uk/api/<repo>/releases/latest, flattened to the single platform this app can install.UpdateRepository.ktThe Kepr side of in-app updates: what the newest release is, fetching its APK, and proving that APK is the one Kepr published before it is ever handed to the package installer.vault/
BrowserSlot.ktReads the browser extension's slot A so Android can restore a vault that was created there — a Codex printed from the extension, most importantly.Canary.ktDuressConfig.ktThe action Peach takes when the duress passphrase is entered at the lock screen.JwkString.ktReads a passkey's
privateKeyJwk whether it arrives as a JSON object or a string, and writes it back as an object.LastViewedEntryStore.ktRemembers the id of the entry the user last opened so a fresh unlock can land straight back on it (matching the extension, which opens the last entry rather than the list).PasskeyData.ktPasswordGenerator.ktCryptographically random password generator.PasswordHistoryItem.ktOne past password kept in [VaultEntry.passwordHistory].PeachPayloadCodec.ktPeachScript binary payload (PCHS) — a byte-for-byte port of the browser's peachPayload.ts (MF-2).PeachScript.ktPeachScript outer codec — maps each payload byte to one Private-Use-Area code point in U+E000..U+E0FF, and back.RecoveryWordList.ktRecovery word list — byte-identical to the browser's src/shared/recovery-word-list.ts: the canonical 2048-word BIP39 English list, 0-indexed, no duplicates.RecoveryWords.ktSavedIdentity.ktTOTPGenerator.ktRFC 6238 TOTP / RFC 4226 HOTP.VaultCrypto.ktVaultEntry.ktVaultHealth.ktVaultLockTimer.ktIdle auto-lock timer.VaultRepository.ktLenient parser for the Codex vault-blob wrapper only.VaultSettings.ktVaultSnapshot.ktVaultStore.ktOne encrypted slot at rest.jniLibs/
arm64-v8a/
armeabi-v7a/
x86_64/
res/
drawable/
font/
layout/
mipmap-anydpi-v26/
values/
test/
java/
com/
peachpasswords/
codex/
feedback/
license/
security/
shared/
sync/
BackgroundSyncCoordinatorTest.ktThe v2.5.13 gate
if (enabled && vault.isUnlocked.value) was wrong: the user almost always enables background sync from Settings while the vault is locked, so the service never started and the device stayed invisible to paired peers.BackgroundSyncPreferenceTest.ktC7TransportTest.ktC7 transport tests.CloudRelayDialerTest.ktPhone-to-phone: the case that had no initiator at all.CloudRelayReconnectListenerTest.ktEnough of a vault to send SYNC_HELLO; the peer stalls before anything else.ForegroundSyncCoordinatorTest.ktNoiseKKTest.ktPairedDeviceRevocationTest.ktPairingAuthTest.ktPairingInvitationTest.ktPeachWebSocketTest.ktExercises the server against OkHttp's RFC 6455 client rather than a hand-rolled one.RelayAdoptionHostTest.ktRelayGateTest.ktThe fail-closed relay gate, mirroring the browser's sync-settings.test.ts.RelaySettingsPropagationTest.ktWhat a relay change does to the existing mesh, mirroring the browser's setSyncMode / setRelayUrl.RendezvousTest.ktSyncAlertTest.ktSyncCoordinatorTest.ktTwo in-memory [SyncSession]s wired back to back.SyncFrameTransportTest.ktE7b end-to-end chunking — the deliverable for the wire shape.SyncFreshStartResetterTest.ktSyncNotificationPersistenceTest.ktSyncOutcomeTest.ktThe indicator light is the whole point of this vocabulary, so the mapping is swept exhaustively rather than sampled: a reason added later has to be given a place here or the sweep fails.SyncPaddingTest.ktSyncServiceStartTest.ktThe service start is the first step of every sync path, and it was the one step that could throw straight out of a button press: Android 12+ refuses a foreground service started from the background, and startForegroundService was called bare.SyncSuiteTest.ktSync suite (brief Suite 13): length-prefixed pairing frames, SAS derivation KAT, and cross-device entry sync through the [VaultSyncAdapter] (two repositories made to share a sync root key via the Codex blob).VaultAdoptTest.ktAdoption frame protocol parity with the browser vault-adopt.test.ts.VaultSyncAdapterTest.ktui/
lock/
onboarding/
pairing/
vault/
EntryDetailParityTest.ktEntryDetailScreenTest.ktEntryDetail suite (brief Suite 4): the screen's pure rendering logic — full-title ghost watermark, NOTE routing, breach-banner predicate, TOTP timing/hot-state, and masked card display.EntryEditExtraTest.ktEntryEdit suite expansion (brief Suite 5): the new-card field logic (network detection, PAN/CVC limits, expiry validation) and the password generator the editor drawer drives.EntryEditScreenTest.ktExportRoundTripTest.ktGhostWatermarkTest.ktImportParsersTest.ktNoteHtmlTest.ktThe vocabulary under test is the browser sanitizer's allow-list (NoteEditor.tsx ALLOWED_NOTE_TAGS): b, i, u, s, strong, em, h2, h3, ul, ol, li, br, hr, p — plus the div wrappers contenteditable adds on its own.NotesModeTest.ktRealBackupDecodeTest.ktDecode-path check against a real, full-size PeachScript backup rather than a toy fixture.VaultListSyncAlertTest.ktVaultSearchParityTest.kt
updates/
vault/
BrowserPasskeyJwkTest.ktA passkey's
privateKeyJwk is a JSON OBJECT in the browser (JsonWebKey in shared/types.ts); Android holds it as a compact string.BrowserSlotTest.ktPins the browser→Android slot-A translation that Codex restore depends on.CardSerializationTest.ktIn-memory [VaultStorage] for exercising last4 derivation on save (MF-3).CrossPlatformRecoveryWordsTest.ktRecovery words are only a human-readable encoding of the root key's first 16 bytes, so the two platforms MUST agree on the word list byte for byte.DuressSlotBTest.ktIn-memory [VaultStorage] including a decoy (slot B) slot, for the MF-6 duress model.OfficialCryptoVectorsTest.ktPasskeyEntryTest.ktPasswordGeneratorTest.ktPeachScriptRoundTripTest.ktPeachScript + CSV round-trip suite (brief Suite 7): large-vault fidelity, ciphertext tamper detection, size-bucket padding, and CSV column/injection behavior.PeachScriptTest.ktRecoveryEscrowIntegrationTest.ktIntegration coverage for the full create → confirm → seal → unlock recovery chain (brief Fix 1).RecoveryEscrowSuiteTest.ktRecoveryEscrow suite (brief Suite 3): word validation/autocomplete, partial and wrong-word failures, missing-escrow handling, recovery-driven password reset, and the duress-mode guard that recovery escrows are never sealed for the decoy.RecoveryEscrowTest.ktSlotAUnlockTest.ktIn-memory [VaultStorage] for the non-committing dual-derivation path (MF-5).SlotPaddingTest.ktExposes the raw stored slots so the padding lengths (MN-1) can be inspected.TOTPGeneratorTest.ktVaultCryptoKdfTest.ktMF-4: the Argon2id KDF must hash the password's explicit UTF-8 bytes (matching the browser's TextEncoder().encode), not its UTF-16 code units.VaultCryptoTest.ktVaultCrypto suite (brief Suite 2): Argon2id key derivation, AES-256-GCM round-trips, AAD enforcement, and KDF parameters.VaultHealthTest.ktVaultHealth suite (brief Suite 8): the pure [VaultHealth.buildReport] scoring — breach / reused / weak / aged / sensitivity detection, section counts, and the sensitivity-weighted vault score.VaultLockTimerTest.ktIn-memory [VaultStorage] so the timer can drive a real repository off-device.VaultRepositoryExtraTest.ktSecond VaultRepository suite (brief Suite 1 expansion).VaultRepositoryTest.ktIn-memory [VaultStorage] so the repository can be exercised without Android.widget/
gradle/
app/build.gradle actually declares versionName "2.2.0" / versionCode 202000.settings.gradleVERSIONhistory
4f2c5bf3279bfix: redirect locked vault destinations (v2.7.14)2 months ago47e77d4ba508fix: open populated phones directly at pairing (v2.7.13)2 months ago7c32509a6aa3phone reads vaultStatus from the scanned invitation and switches roles: 'empty' → grantAdoption (send the vault to the empty browser), 'populated' or missing → existing receiver flow unchanged. Defaults to 'populated' for older invitations so historical sync is unaffected. (v2.7.12)2 months ago4e097b1b4521chaos destroy screen: red header 'THIS IS YOUR LAST CHANCE', three single-sentence warnings in breach red, solid red 'DESTROY MY VAULT FOREVER' button, 'No — take me back' escape (v2.7.11)2 months agoe8637519f572drop the first-contact block on populated vault adoption: a second browser, tablet, or phone is now welcome to scan a QR and join an existing mesh as long as the vault id matches. The vault-id check in createVaultFromRootKey is the real security boundary; the prior known-peer gate prevented the intended N-device mesh and is removed (v2.7.10)2 months ago7c92cad1f1f8restore the QR scan entry point in Sync > Add a device: alongside 'show code', a 'scan' button opens the camera-driven AdoptVault flow so a phone can join an existing browser-only vault (v2.7.9)2 months ago727903630472treat a peer's post-DONE hang-up as a completed sync, not errored; add CONNECTION_LOST outcome and a WARN indicator tier so network-class misses (relay/handshake/timeout/connection_lost) read amber, not red, mirroring the browser fix (v2.7.8)2 months ago33515d267786docs: Record v2.7.7 physical install2 months agoee76db7f27e3feat: Add long-press selection to vault and Notes (v2.7.7)2 months ago916249d84985fix: Require a visible background sync notification (v2.7.6)2 months ago99fee5aa1ebcfix: Move Sync security alerts to notifications (v2.7.5)2 months agocca4cca7f47efix: Flush final adoption acknowledgement (v2.7.4)2 months agoc13446e90feadocs: Record v2.7.3 device validation2 months agobee916190cd6fix: Show adoption password validation feedback (v2.7.3)2 months ago8d6cf9d4e33bfix: Keep relay capabilities out of logs (v2.7.2)2 months agoea87fc9113f8fix: Default private relay fields to wss scheme (v2.7.1)2 months agoaeae7c03641ffeat: Let vault presence direct pairing (v2.7.0)2 months agoe4607bb6696bfix: Make vault destruction reset Sync state (v2.6.2)2 months agofb46840009b2feat: Keep routine sync quiet (v2.6.1)2 months agoccf5e6f8b042feat: Simplify Sync Settings with progressive disclosure (v2.6.0)2 months agod7406e5e9d9dfix: Collapse stacked sync updates in the vault (v2.5.23)2 months agod620000dab23feat: Make pairing safe, QR-only, and single-confirm (v2.5.22)2 months agod2b3473d34edfix: Clear receiver re-pair revocation (v2.5.21)2 months ago7b366ada2ceafix: Replace relay waiters without reconnect storms (v2.5.20)2 months ago6d4f0fd4366afix: Refresh stale relay waiters on sync now (v2.5.19)2 months agoe5e2965ac456chore: Trace sync protocol receive stages (v2.5.18)2 months agoec914e23f6d4fix: Restore dismissed sync notification (v2.5.17)2 months ago2dfe4d9c3398fix: Remove stale revoked device rows (v2.5.16)2 months agof90df691e6d2add PeachSync relay reconcile, room, socket, and dial diagnostics with log-capture coverage (v2.5.15)2 months agod115d87bd22aremove the locked-state gate from setBackgroundSyncEnabled and add a vault-unlock observer so the sync service starts whenever preference is on (v2.5.14)2 months ago4b98699ba304ask paired users about persistent background sync, honor manual-only opt-out in settings, and default existing installs on (v2.5.13)2 months ago4ebae050a135mirror chunking on Android with the marker wire shape from peach-browser sync-transport.ts; route every encrypt-of-padded-frame callsite through sendSyncFrame/receiveSyncFrame, slice non-last chunks at MAX-1 to leave room for the marker, and pin the constants and the bucket ladder in cross-platform KAT (v2.5.12)3 months ago7b389c585363add SyncFrameTransport chunking helper and cross-platform KAT constants; route every encrypt-of-padded-frame callsite through it3 months agodcb2093343f2the dialler's outer bound stops racing the coordinator's session timeout: DIAL_SESSION_TIMEOUT_MS is now derived as SESSION_TIMEOUT_MS + 15s of handshake headroom (45s) instead of a hand-written 30s equal to it, so a stalled peer is always named SYNC_TIMEOUT by the coordinator rather than cancelled by whichever of two equal deadlines the scheduler reached first; the outer bound now only fires for the empty-room case it was written for, and reports it as HANDSHAKE_FAILED with a distinguishing detail line instead of rethrowing a cancellation nobody reports (v2.5.11)3 months ago0c5ab4dfdcdfa foreground-service start Android refuses becomes a reported FOREGROUND_START_BLOCKED instead of a crash or silence: PeachSyncService.start and onStartCommand's own startForeground both route through startOrReportBlocked, which catches IllegalStateException (the supertype of API 31's ForegroundServiceStartNotAllowedException, so no minSdk guard is needed) and reports through SyncOutcomeStore, fetched via a Hilt EntryPoint so all six call sites are covered by the one guard; a refused START_STICKY restart now stops itself rather than returning to be refused again3 months agocf0e3a2db9ddrelay changes reach existing pairs: setSyncMode/setRelayUrl push the in-force relay into every paired device through the relayInForce gate, so private-unset and off push nothing; adoption records the source's relay so the Sync card stops claiming Public on a phone dialling a private one (v2.5.10)3 months ago90740782e940fail closed on private relay with no address: relayInForce gate, PRIVATE_RELAY_UNSET outcome, honest empty relay field (v2.5.9)3 months ago29ce33a356c2note why PeachSyncService's locked-vault early return stays silent3 months ago4b1a7052c2deversion 2.5.8 / build 240108 (v2.5.8)3 months agoce4aae51c322route every terminating sync path through SyncOutcomeStore: relay sessions report failures instead of swallowing them, syncNow drops the unearned LastSynced claim3 months agof7bb934c823badd SyncOutcomeReason vocabulary and persistent SyncOutcomeStore mirroring the browser's sync-outcome contract3 months ago729a9f19fd13version 2.5.7 / build 240107 (v2.5.7)3 months ago140731f8bafbentry detail and the entry edit form take the same note round trip as notes mode: the notes row displays parsed HTML and copies plain text, the form loads markup and writes the tags back, so a login's formatted note is no longer flattened by an edit on the phone3 months ago052628df2835note bodies parse the browser's tag vocabulary (b/strong, i/em, u, s, h2, h3, ul, ol, li, br, hr, p, plus contenteditable's divs) into an AnnotatedString: notes mode opens rendered and edits a plain-text markup that serialises back to the same tags on save, so a formatted note survives a phone edit; the TOC preview line and note search read rendered text instead of raw markup3 months ago231dc4b86232text size control and the fictional Shortcuts card removed — neither had any reader; continuity records the per-control audit (v2.5.6)3 months ago3492ddd79dbdpeach on android is dark-only: light palette, theme-mode branching, the inverted values-night light resources and the theme setting all gone (v2.5.6)3 months ago49be2ef5e42ematch device revocation on the revoked long-term key, not just the self-asserted deviceId, so a revoked device cannot return under a fresh id (v2.5.5)3 months ago3831ea3a2d15correct the feedback record: the old key had no account behind it, so the 200 success it returned was never evidence of delivery3 months agofa9a48cf0dc1point Android feedback at the Web3Forms account that actually exists, matching the extension's new key (v2.5.4)3 months ago6e1ed815b3b9record the feedback wiring, the completed chirp rename, why the persisted identity keys keep their stale names, and how to get a file name out of a failing kapt run3 months ago
details
Peach for Android
A free, open source, local-first password manager for Android.
No accounts. No subscription. Your passwords stay on the device, encrypted with AES-256-GCM and protected by Argon2id key derivation. Sync, backup, and autofill happen without trusting any cloud in the middle.
Features
- Zero-knowledge vault — AES-256-GCM encryption, Argon2id KDF, keys never leave your device
- End-to-end encrypted sync — pairs with your other Peach devices over a Noise channel; the relay only forwards ciphertext it cannot read
- Inline autofill — fills directly in apps, no copy-paste detour
- Passkeys — WebAuthn credentials alongside your passwords
- Quick Settings tile — copy a credential from anywhere with a single tap
- Biometric unlock — hardware-backed AndroidKeyStore escrow, invalidated on enrollment change
- Codex — prints your encrypted vault as Aztec codes on paper. Physical offline backup
Open Source
Peach is free and open source under the GPL v3 license. Both the browser extension and the Android app.
The source is hosted on Kepr — Asha Software's own version control platform.
Security
Peach has undergone two adversarial analysis sessions against this codebase. The most recent findings have been resolved.
Cryptographic primitives:
- Key derivation: Argon2id (m=64MiB, t=3, p=4)
- Encryption: AES-256-GCM with fresh random nonces
- Sync handshake: Noise NK / Noise KK (25519, ChaChaPoly, BLAKE2s)
- Backup codec: GF(2⁸) Reed-Solomon with zstd compression
- BLAKE3 checksums throughout
The canonical Noise core lives in a shared Rust crate with the browser extension — Android drives it via JNI. See docs/CRYPTOGRAPHIC-TEST-VECTORS.md for the byte-level vectors that pin each primitive.
Building
./gradlew assembleRelease
Outputs to app/build/outputs/apk/release/. The shared Noise core is built from ../peach-browser/crypto-core.
License
GPL v3 — see LICENSE.
Peach Pro
Pro features (end-to-end encrypted sync, Codex, Canary) are available for $39 one-time at peachpasswords.com. Purchasing Pro supports continued development.
Built by Asha Software · [email protected]