https://github.com/tetherto/pearpass-app-desktop
PearPass is an open-source, privacy-first password manager with peer-to-peer syncing and end-to-end encryption.
https://github.com/tetherto/pearpass-app-desktop
Last synced: 5 months ago
JSON representation
PearPass is an open-source, privacy-first password manager with peer-to-peer syncing and end-to-end encryption.
- Host: GitHub
- URL: https://github.com/tetherto/pearpass-app-desktop
- Owner: tetherto
- License: apache-2.0
- Created: 2025-12-09T19:12:39.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-13T11:07:33.000Z (5 months ago)
- Last Synced: 2026-01-13T21:17:28.214Z (5 months ago)
- Language: JavaScript
- Homepage: https://pass.pears.com/
- Size: 4.62 MB
- Stars: 299
- Watchers: 4
- Forks: 28
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
- awesome-pears - PearPass-desktop - A distributed password manager powered by Pear Runtime. (**Awesome Pears 🍐** / Pears)
README
# pearpass-app-desktop
PearPass is a distributed password manager powered by Pear Runtime. It allows secure storage of passwords, credit card details, and secure notes, with the ability to distribute data across multiple devices.
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Testing](#testing)
- [Usage Examples](#usage-examples)
- [Dependencies](#dependencies)
- [Related Projects](#related-projects)
## Features
- Secure password, identity, and credit card, notes and custom fields storage
- Cross-device and platform synchronization
- Offline access to your credentials
- Encryption for data security
- Password strength analysis
- Random password generator
- Easy-to-use interface
## Installation
- **Node.js**: Ensure you have the correct Node.js version installed. You can check the required version in the `.nvmrc` file. And ensure it matches to your current node version by running:
```bash
node --version
```
- **Pear**: Ensure you have Pear installed mode details can be found [here](https://docs.pears.com/guides)
Clone the repository
```bash
git clone git@github.com:tetherto/pearpass-app-desktop.git
```
Go to the cloned directory
```bash
cd pearpass-app-desktop
```
To update all submodules to the latest `main` branch, use the provided script.
```bash
npm run update-submodules
```
In case of specific remote use:
```bash
npm run update-submodules -- [remote-name]
```
Install npm modules
```bash
npm install
```
generate translation keys
```bash
npm run lingui:extract
```
```bash
npm run lingui:compile
```
run the app
```bash
pear run --dev .
```
## Testing
### Unit Testing
Run unit tests with Jest:
```bash
npm test
```
## Staging to dev
Ensure the app runs correctly using `npm run dev`.
If successful, stage it—for example: `pear stage dev`.
Then run the app: `pear run pear://GENERATED_URL`.
Pear serves files from the "dist" folder:
```html
```
The "src" folder is for development and it's ignored in package.json
```json
"ignore": [
".github",
"appling",
".git",
".gitignore",
"packages",
"src"
]
```
## Dependencies
- [Pear Runtime](https://pears.com/)
- [React](https://reactjs.org/)
- [Styled Components](https://styled-components.com/)
- [Lingui](https://lingui.dev/)
- [Redux](https://redux.js.org/)
## Related Projects
- [pearpass-app-mobile](https://github.com/tetherto/pearpass-app-mobile) - A mobile app for PearPass, a password manager
- [pearpass-lib-ui-react-native-components](https://github.com/tetherto/pearpass-lib-ui-react-native-components) - A library of React Native UI components for PearPass
- [pearpass-lib-ui-react-components](https://github.com/tetherto/pearpass-lib-ui-react-components) - A library of React UI components for PearPass
- [pearpass-app-browser-extension](https://github.com/tetherto/pearpass-app-browser-extension) - A browser extension for PearPass, a password manager
- [tether-dev-docs](https://github.com/tetherto/tether-dev-docs) - Documentations and guides for developers
- [pearpass-lib-vault](https://github.com/tetherto/pearpass-lib-vault) - A library for managing password vaults
- [pearpass-lib-vault-core](https://github.com/tetherto/pearpass-lib-vault-core) - A bare worker and a client for PearPass vaults
## License
This project is licensed under the Apache License, Version 2.0. See the [LICENSE](./LICENSE) file for details.