1
0
mirror of https://github.com/bitwarden/mobile synced 2025-01-28 09:19:52 +01:00

35 lines
2.3 KiB
Markdown
Raw Normal View History

2017-03-21 18:12:21 -04:00
[![appveyor build](https://ci.appveyor.com/api/projects/status/github/bitwarden/mobile?branch=master&svg=true)](https://ci.appveyor.com/project/bitwarden/mobile)
2017-05-20 23:19:26 -04:00
[![Crowdin](https://d322cqt584bo4o.cloudfront.net/bitwarden-mobile/localized.svg)](https://crowdin.com/project/bitwarden-mobile)
2016-10-13 22:03:41 -04:00
[![Join the chat at https://gitter.im/bitwarden/Lobby](https://badges.gitter.im/bitwarden/Lobby.svg)](https://gitter.im/bitwarden/Lobby)
2018-02-27 13:27:07 -05:00
# Bitwarden Mobile Application
2016-08-09 22:03:43 -04:00
2017-10-30 16:48:45 -04:00
<a href="https://play.google.com/store/apps/details?id=com.x8bit.bitwarden" target="_blank"><img alt="Get it on Google Play" src="https://imgur.com/YQzmZi9.png" width="153" height="46"></a> <a href="https://itunes.apple.com/us/app/bitwarden-free-password-manager/id1137397744?mt=8" target="_blank"><img src="https://imgur.com/GdGqPMY.png" width="135" height="40"></a>
2016-08-09 22:03:43 -04:00
2018-02-27 13:27:07 -05:00
The Bitwarden mobile application is written in C# with Xamarin Android, Xamarin iOS, UWP, and Xamarin Forms.
2016-08-09 22:03:43 -04:00
<img src="https://raw.githubusercontent.com/bitwarden/brand/master/screenshots/mobile-android.png" alt="" width="300" height="533" /> <img src="https://raw.githubusercontent.com/bitwarden/brand/master/screenshots/mobile-ios.png" alt="" width="300" height="533" />
2017-05-19 13:39:37 -04:00
2016-12-29 00:38:53 -05:00
# Build/Run
**Requirements**
2018-01-14 21:43:25 -05:00
- [Visual Studio](https://store.xamarin.com/)
2016-12-29 00:38:53 -05:00
2018-02-27 13:27:07 -05:00
**API endpoint**
2016-12-29 00:38:53 -05:00
By default the app is targeting the production API. If you are running the [Core](https://github.com/bitwarden/core) API locally,
2017-10-26 11:54:09 -04:00
you'll need to switch the app to target your local instance. Open `src/App/Utilities/ApiHttpClient.cs` and `src/App/Utilities/IdentityHttpClient.cs` and set the `BaseAddress` to your local
API endpoints (ex. `new Uri("http://localhost:5000")`). Alternatively, you can also adjust the environment endpoints from the environment settings page on the home screen of the app (log out).
2016-12-29 00:38:53 -05:00
2018-02-27 13:27:07 -05:00
**Run the app**
2016-12-29 00:38:53 -05:00
After restoring the nuget packages, you can now build and run the app.
2016-08-09 22:03:43 -04:00
# Contribute
Code contributions are welcome! Visual Studio or Xamarin Studio is required to work on this project. Please commit any pull requests against the `master` branch.
2016-12-29 00:26:14 -05:00
Learn more about how to contribute by reading the [`CONTRIBUTING.md`](CONTRIBUTING.md) file.
2016-08-09 22:03:43 -04:00
2017-05-19 13:23:52 -04:00
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.