1
0
mirror of https://github.com/bitwarden/browser synced 2025-01-28 12:09:36 +01:00

61 lines
2.1 KiB
Markdown
Raw Normal View History

2018-07-26 10:02:04 -04:00
<p align="center">
2018-07-26 10:02:24 -04:00
<img src="https://raw.githubusercontent.com/bitwarden/brand/master/screenshots/web-vault-macbook.png" alt="" width="600" height="358" />
2018-07-26 10:02:04 -04:00
</p>
2018-07-26 09:54:36 -04:00
<p align="center">
2018-07-26 10:02:24 -04:00
The Bitwarden web project is an Angular application that powers the web vault (https://vault.bitwarden.com/).
2018-07-26 09:54:36 -04:00
</p>
<p align="center">
<a href="https://ci.appveyor.com/project/bitwarden/web/branch/master" target="_blank">
<img src="https://ci.appveyor.com/api/projects/status/github/bitwarden/web?branch=master&svg=true" alt="appveyor build" />
</a>
<a href="https://crowdin.com/project/bitwarden-web" target="_blank">
<img src="https://d322cqt584bo4o.cloudfront.net/bitwarden-web/localized.svg" alt="Crowdin" />
</a>
<a href="https://hub.docker.com/u/bitwarden/" target="_blank">
<img src="https://img.shields.io/docker/pulls/bitwarden/web.svg" alt="DockerHub" />
</a>
<a href="https://gitter.im/bitwarden/Lobby" target="_blank">
<img src="https://badges.gitter.im/bitwarden/Lobby.svg" alt="gitter chat" />
</a>
</p>
2016-10-13 22:02:46 -04:00
2018-07-26 10:02:04 -04:00
## Build/Run
2018-07-26 10:02:04 -04:00
### Requirements
2018-07-09 16:38:21 -04:00
- [Node.js](https://nodejs.org) v8.11 or greater
2018-07-26 10:02:04 -04:00
### Run the app
2017-07-14 08:32:30 -04:00
2018-07-09 16:38:21 -04:00
```
npm install
npm run build:watch
```
2018-07-09 17:01:15 -04:00
You can now access the web vault in your browser at `https://localhost:8080`. You can adjust your API endpoint settings in `src/app/services/services.module.ts` by altering the `apiService.setUrls` call. For example:
2018-07-09 17:02:03 -04:00
```typescript
2018-07-09 17:01:15 -04:00
await apiService.setUrls({
base: isDev ? null : window.location.origin,
api: isDev ? 'http://mylocalapi' : null,
identity: isDev ? 'http://mylocalidentity' : null,
});
```
2018-07-26 09:25:43 -04:00
If you want to point the development web vault to the production APIs, you can set:
2018-07-09 17:01:15 -04:00
2018-07-26 09:25:43 -04:00
```typescript
await apiService.setUrls({
base: null,
api: 'https://api.bitwarden.com',
identity: 'https://identity.bitwarden.com',
});
2018-07-09 17:01:15 -04:00
```
2018-07-26 09:25:43 -04:00
2018-07-26 10:02:04 -04:00
## Contribute
2016-10-01 23:32:12 -04:00
Code contributions are welcome! Please commit any pull requests against the `master` branch.
2017-05-19 13:27:22 -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.