README.md

   1 # Web clients
   2
   3 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).
   4
   5 -   <img src="./applications/mail/src/favicon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton Mail</span>
   6 -   <img src="./applications/calendar/src/favicon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton Calendar</span>
   7 -   <img src="./applications/drive/src/favicon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton Drive</span>
   8 -   <img src="./applications/account/src/favicon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton Account</span>
   9 -   <img src="./applications/vpn-settings/src/favicon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton VPN</span>
  10 -   <img src="./applications/pass-extension/public/assets/protonpass-icon.svg" style="vertical-align: middle" height="20" width="20" /> <span style="vertical-align: middle; display: inline-block">Proton Pass</span>
  11
  12 Technically, this monorepo is based on Yarn 3 & Yarn Workspaces, with unified versioning for all packages inside.
  13
  14 ## Getting Started
  15
  16 You'll need to have the following environment to work with this project
  17
  18 -   Node.js LTS
  19 -   Yarn 3
  20 -   git
  21
  22 You can find more detailed version-constrains for Node.js and yarn in `package.json`.
  23
  24 ```shell
  25 # Clone the project
  26 git clone https://github.com/ProtonMail/WebClients.git
  27 git clone git@github.com:ProtonMail/WebClients.git
  28
  29 # Install all dependencies for the entire monorepo & symlink
  30 # local dependents to one another
  31 yarn install
  32
  33 # Run web clients by running proton-<package-name>
  34 # Example: proton mail web client
  35 yarn workspace proton-mail start
  36 ```
  37
  38 For additional details on how to interact with the monorepo, see the [yarn docs](https://yarnpkg.com/) for reference.
  39
  40 ## Help us to translate the project
  41
  42 You can learn more about it on [our blog post](https://proton.me/blog/translation-community).
  43
  44 ## License
  45
  46 The code and data files in this distribution are licensed under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See https://www.gnu.org/licenses/ for a copy of this license.
  47
  48 See [LICENSE](LICENSE) file