--- # Bitwarden Client Applications This repository houses all Bitwarden client applications except the [Mobile application](https://github.com/bitwarden/mobile). Please check the readmes for each application under `apps` for instructions on how to build the different applications. ## Related projects: - [bitwarden/server](https://github.com/bitwarden/server): The core infrastructure backend (API, database, Docker, etc). - [bitwarden/mobile](https://github.com/bitwarden/mobile): The mobile app vault (iOS and Android). - [bitwarden/directory-connector](https://github.com/bitwarden/directory-connector): A tool for syncing a directory (AD, LDAP, Azure, G Suite, Okta) to an organization. # We're Hiring! Interested in contributing in a big way? Consider joining our team! We're hiring for many positions. Please take a look at our [Careers page](https://bitwarden.com/careers/) to see what opportunities are currently open as well as what it's like to work at Bitwarden. # Contribute Code contributions are welcome! Please commit any pull requests against the `master` branch. Learn more about how to contribute by reading the [`CONTRIBUTING.md`](CONTRIBUTING.md) file. Security audits and feedback are welcome. Please open an issue or email us privately if the report is sensitive in nature. You can read our security policy in the [`SECURITY.md`](SECURITY.md) file. ## Git blame We recommend that you configure git to ignore specific revision using: ```bash git config blame.ignoreRevsFile .git-blame-ignore-revs ``` ## Migrate PRs from old repositories We recently migrated from individual client repositories. And some PRs were unfortunately left behind in the old repositories. Luckily it's fairly straightforward to sync them up again. Please follow all the instructions below in order to avoid most merge conflicts. ### Desktop ``` # Merge master git merge master # Merge branch mono-repo-prep git merge 28bc4113b9bbae4dba2b5af14d460764fce79acf # Verify files are placed in apps/desktop # Add remote git remote add clients git@github.com:bitwarden/clients.git # Merge against clients master git fetch clients git merge clients/master # Push to clients or your own fork ```