+0
日增长
5,691
stars
742
forks
168
watchers
0
prs
404
issues
586
releases
README
Web clients This project is a monorepo hosting the Proton web clients. It includes the web applications, their dependencies & shared modules as well as all tooling surrounding development of the web clients (as well as some additional miscellaneous things). - Proton Mail - Proton Calendar - Proton Drive - Proton Account - Proton VPN - Proton Pass - Proton Wallet - Proton Lumo - Proton Meet Technically, this monorepo is based on pnpm & pnpm workspaces, with unified versioning for all packages inside. Getting Started Prerequisites You'll need to have the following environment to work with this project: - Node.js satisfying engines.node in the root package.json (a .node-version file is provided for fnm, mise, and similar tools, and a matching .nvmrc for nvm — keep both in sync) - pnpm satisfying engines.pnpm in the root package.json (install with your preferred method, e.g. npm install -g pnpm) - git CI installs the exact pnpm version from the packageManager field; locally, any version that satisfies engines.pnpm is fine. Wrong package managers are rejected at install time (preinstall), and engine-strict=true in .npmrc makes pnpm install fail when Node or pnpm is below the declared floors. Installation shell Clone the project git clone https://github.com/ProtonMail/WebClients.git git clone [email protected]:ProtonMail/WebClients.git Install all dependencies for the entire monorepo & symlink local dependents to one another pnpm install Run web clients by running proton- Example: proton mail web client pnpm --filter proton-mail run start For additional details on how to interact with the monorepo, see the pnpm docs for reference. Shared dependency versions (catalog) Every workspace declares the dependencies it imports. When many workspaces declare the same dependency and must stay on the same version, the range lives once in the catalog: section of pnpm-workspace.yaml, and each workspace references it with "catalog:" instead of a range: json "devDependencies": { "@types/node": "catalog:" } Use catalog: when: - the dependency is declared by several workspaces (as a rule of thumb, three or more), and - they have to move together, for example the @types packages that tsconfig.base.json lists in compilerOptions.types, or a package where two versions in the tree would break things. Declare a plain range instead when: - only one or two workspaces use the dependency; - a workspace deliberately needs a different version (for example utilities/lumo-dev-proxy keeps @types/node@^22); - it's another workspace: use workspace:^; - you need to pin a transitive dependency, for example for a security fix: use overrides in pnpm-workspace.yaml, since the catalog only applies to workspaces that reference it. To add an entry, add the range to catalog: and switch every existing declaration of that dependency to "catalog:" in the same change. To bump it, change the range in pnpm-workspace.yaml only. Either way, run pnpm install and
Top issues
#453Proton Pass Web Extension - Autofill keyboard shortcut contribution18 comments · 2025-08-07#354Unavailable releases/branches for reproducible builds17 comments · 2023-10-31#401Allow passkeys for insecure domain (`localhost`)16 comments · 2024-07-15#253Inline image support in ProtonMail with regard to other PGP softwares10 comments · 2021-09-15#277Why is ProtonMail support so atrocious? Fulltext search does not work properly8 comments · 2022-05-28#440Yarn error: Workspace "@proton/collect-metrics@workspace:^" not found7 comments · 2025-05-15#516Autofill does not detect Authentik login fields (inputs inside shadow DOM)6 comments · 2026-06-22#415Yarn version for this project is 3 or 4?6 comments · 2024-11-06