Upstream/bitwarden-browser
1
0
Fork 0
mirror of https://github.com/bitwarden/browser.git synced 2024-11-08 09:43:42 +01:00
Code Issues Projects Releases Wiki Activity
76752f81c6
bitwarden-browser/README.md
Kyle Spearrin f73e1f4399 update readme for build folder
2017-11-16 11:25:43 -05:00

3.3 KiB
Raw Blame History

appveyor build Crowdin Join the chat at https://gitter.im/bitwarden/Lobby

bitwarden Browser Extension

The bitwarden browser extension is written using the Chrome Web Extension API and AngularJS.

Alt text

Build/Run

Requirements

  • Node.js
  • Gulp (npm install --global gulp-cli)
  • Chrome (preferred), Opera, or Firefox browser

By default the extension is targeting the production API. If you are running the Core API locally, you'll need to switch the extension to target your local instance. Open src/services/api.service.ts and set this.baseUrl and this.identityBaseUrl to your local API instance (ex. http://localhost:5000).

Then run the following commands:

npm install
npm run dev:watch

You can now load the extension into your browser through the browser's extension tools page:

  • Chrome/Opera:
    1. Type chrome://extensions in your address bar to bring up the extensions page.
    2. Enable developer mode (checkbox)
    3. Click the "Load unpacked extension" button, navigate to the build folder of your local extension instance, and click "Ok".
  • Firefox
    1. Type about:debugging in your address bar to bring up the add-ons page.
    2. Click the Load Temporary Add-on button, navigate to the build/manifest.json file, and "Open".

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 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 file.