Upstream/bitwarden-browser
1
0
Fork 0
mirror of https://github.com/bitwarden/browser.git synced 2024-11-24 12:06:15 +01:00
Code Issues Projects Releases Wiki Activity
The browser extension vault (Chrome, Firefox, Opera, Edge, Safari, & more).
3,817 Commits 697 Branches 458 Tags 951 MiB
TypeScript 81.8%
HTML 12.6%
SCSS 2.3%
JavaScript 1.6%
MDX 0.9%
Other 0.7%
d9ac8cc50a
Go to file
Micaiah Martin d9ac8cc50a Ignored workflow files from triggering builds
2022-02-24 11:20:04 -06:00
.github Ignored workflow files from triggering builds 2022-02-24 11:20:04 -06:00
.husky Make husky pre-commit script executable (#2316) 2022-02-08 08:35:49 +10:00
jslib@1cbc119ad8 Update jslib (#2407) 2022-02-24 09:33:58 -05:00
src Update jslib (#2407) 2022-02-24 09:33:58 -05:00
store Autosync the updated translations (#2295) 2022-01-28 11:08:11 +01:00
.editorconfig Add Prettier configuration (#2237) 2021-12-21 15:15:19 +01:00
.git-blame-ignore-revs Add .git-blame-ignore-revs (#2240) 2021-12-21 16:44:00 +01:00
.gitattributes Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
.gitignore ignore dist-safari 2020-09-28 10:40:51 -04:00
.gitmodules convert to jslib submodule 2018-02-19 17:01:00 -05:00
.prettierignore Apply prettier for previously ignored file 2022-01-04 16:41:07 +01:00
.prettierrc.json Add Prettier configuration (#2237) 2021-12-21 15:15:19 +01:00
CONTRIBUTING.md Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
crowdin.yml Updating the Crowdin update process 2021-11-04 13:02:06 -07:00
gulpfile.js [bug] Update gulp and webpack to include new font sheet (#2305) 2022-02-02 09:11:09 -06:00
karma.conf.js Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
LICENSE.txt license 2016-10-10 18:36:38 -04:00
package-lock.json [Icons] FF - requested icon changes (#2306) 2022-02-03 10:25:38 -06:00
package.json Exclude jslib from prettier hook (#2386) 2022-02-17 10:37:56 +10:00
README.md We're Hiring (#2403) 2022-02-22 14:03:20 +01:00
SECURITY.md Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
tsconfig.json Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
tslint.json Apply Prettier (#2238) 2021-12-21 15:43:35 +01:00
webpack.config.js Fix console warnings in notification content script (#2388) 2022-02-15 08:09:02 -06:00

README.md

Github Workflow build on master Crowdin Join the chat at https://gitter.im/bitwarden/Lobby

Bitwarden Browser Extension

The Bitwarden browser extension is written using the Web Extension API and Angular.

Build/Run

Requirements

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

Run the app

npm install
npm run build: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 (toggle switch)
    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".

Desktop communication

Native Messaging (communication between the desktop application and browser extension) works by having the browser start a lightweight proxy baked into our desktop application.

Out of the box, the desktop application can only communicate with the production browser extension. When you enable browser integration in the desktop application, the application generates manifests which contain the production IDs of the browser extensions. To enable communication between the desktop application and development versions of browser extensions, add the development IDs to the allowed_extensions section of the corresponding manifests.

Manifests are located in the browser subdirectory of the Bitwarden configuration directory. For instance, on Windows the manifests are located at C:\Users\<user>\AppData\Roaming\Bitwarden\browsers and on macOS these are in Application Support for various browsers (for example). Note that disabling the desktop integration will delete the manifests, and the files will need to be updated again.

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

Prettier

We recently migrated to using Prettier as code formatter. All previous branches will need to updated to avoid large merge conflicts using the following steps:

  1. Check out your local Branch
  2. Run git merge cebee8aa81b87cc26157e5bd0f879db254db9319
  3. Resolve any merge conflicts, commit.
  4. Run npm run prettier
  5. Commit
  6. Run git merge -Xours 8fe821b9a3f9728bcb02d607ca75add468d380c1
  7. Push

Git blame

We also recommend that you configure git to ignore the prettier revision using:

git config blame.ignoreRevsFile .git-blame-ignore-revs