A modern, open source password manager for individuals and teams.
Go to file
Coluzzi Andrea 16b50df550
Italian Translations v4 (#524)
* IT translations: fix old PR comments

* IT translations: WIP v4 tokens

* IT translations: WIP v4 tokens

* IT translations: added v4 tokens
2022-08-03 07:18:36 +01:00
.do Remove databases field from app spec template in an effort to make "deploy to digitalocean" button work 2021-08-21 09:32:32 +02:00
.github/workflows Prepare CI and docs for branch rename 2022-07-19 11:11:37 +01:00
.vscode Checksums - Allow anyone to confirm source and delivered code (#467) 2022-06-20 07:34:45 +01:00
assets Apparently prettier doesn't like <pre></pre> inside <p></p> 2022-07-29 16:49:40 +02:00
cypress Add snap and flatpak options to electron publishing and release 2022-07-04 12:22:12 +01:00
docs Implement postgres logger 2022-07-29 17:30:53 +02:00
nginx Only attempt to start amplify agent if amplify key is set 2021-12-15 13:16:57 +01:00
packages Italian Translations v4 (#524) 2022-08-03 07:18:36 +01:00
.dockerignore Add docker support 2019-05-28 19:54:26 +02:00
.gitignore Add snap and flatpak options to electron publishing and release 2022-07-04 12:22:12 +01:00
.npmrc Lock dependencies' versions 2021-12-15 16:16:37 +00:00
.nvmrc Lock dependencies' versions 2021-12-15 16:16:37 +00:00
.prettierignore Exclude translations and word lists from prettier checks 2022-08-02 10:19:13 +02:00
.prettierrc.json Automatically wrap lines in markdown files at 80 characters 2022-02-25 16:25:33 +01:00
CHANGELOG.md Automatically wrap lines in markdown files at 80 characters 2022-02-25 16:25:33 +01:00
Dockerfile-pwa Add examples of docker-based hosting setup 2022-04-12 15:05:22 +02:00
Dockerfile-server Add examples of docker-based hosting setup 2022-04-12 15:05:22 +02:00
LICENSE Update main readme; Add AGPL license; add shorter/better aliases for some commands 2022-02-25 16:25:33 +01:00
README.md Update branch name ist test badge 2022-07-25 13:57:16 +02:00
cypress.env.json Fix server crashing with malformed requests 2022-02-17 14:33:07 +00:00
cypress.json Find Item e2e test 2022-02-08 14:55:29 +00:00
docker-compose.yml Fix default assets path in docker-compose 2021-12-15 12:55:39 +01:00
karma.conf.js A few improvements, requested from the review: 2021-12-20 15:01:25 +00:00
lerna.json A few improvements, requested from the review: 2021-12-20 15:01:25 +00:00
package-lock.json Fix critical vulnerabilities in dependencies 2022-07-20 08:43:05 +01:00
package.json Fix critical vulnerabilities in dependencies 2022-07-20 08:43:05 +01:00
security.md Automatically wrap lines in markdown files at 80 characters 2022-02-25 16:25:33 +01:00
tsconfig.json Checksums - Allow anyone to confirm source and delivered code (#467) 2022-06-20 07:34:45 +01:00

README.md

Padloc

Simple, secure password and data management for individuals and teams.

About

This repo is split into multiple packages:

Package Name Description
@padloc/core Core Logic
@padloc/app Web-based UI components
@padloc/server The Backend Server
@padloc/pwa The Web Client, a Progressive Web App.
@padloc/locale Package containing translations and other localization-related things
@padloc/electron The Desktop App, built with Electron
@padloc/cordova Cordova project for building iOS and Android app.
@padloc/tauri Cross-platform native app, powered by Tauri
@padloc/extension Padloc browser extension

How to use

As you can see in the About section, there are lots of different components to play with! But at a minimum, in order to set up and use your own instance of Padloc you'll need to install and configure the Server and Web Client. In practice, there a few different ways to do this, but if you just want to install and test Padloc locally, doing so is really quite easy:

git clone git@github.com:padloc/padloc.git
cd padloc
npm ci
npm start

The web client is now available at http://localhost:8080!

In-depth guides on how to host your own "productive" version of Padloc and how to build and distribute your own versions of the desktop and mobile apps are coming soon!

Contributing

All kinds of contributions are welcome!

If you want to report a bug or have a feature request, please create an issue.

If you have question, feedback or would just like to chat, head over to the discussions section.

If you want to contribute to Padloc directly by implementing a new feature or fixing an existing issue, feel free to create a pull request! However if you plan to work on anything non-trivial, please do talk to us first, either by commenting on an existing issue, creating a new issue or by pinging us in the dissusions section!

To learn how to get started working on Padloc, refer to the Development section of the readme.

Security

For a security design overview, check out the security whitepaper.

Development

Setup

Setting up your dev environment for working with Padloc is as simple as:

git clone git@github.com:padloc/padloc.git
cd padloc
npm ci

This may take a minute, so maybe grab a cup of .

Dev Mode

To start "dev mode", simply run

npm run dev

from the root of the project. This will start the backend server (by default listening on port 3000), as well as the PWA (available on http://localhost:8080) by default.

The server and PWA port can be changed vie the PL_TRANSPORT_HTTP_PORT and PL_PWA_PORT environvent variables, respectively. For more configuration options, check out the Conguration section of the server and pwa.

Formatting

This project is formatted with Prettier. To re-format all files using our .prettierrc.json specification, run the following from the root of the project.

npm run format

To simply check whether everything is formatted correctly, you can use the following command:

npm run format:check

Testing

To run unit tests, use:

npm run test

Cypress end-to-end tests can be run via:

npm run test:e2e

And to start cypress tests in "dev mode":

npm run test:e2e:dev

Adding / removing dependencies

Since this is a monorepo consisting of multiple packages, adding/removing to/from a single package can be less than straightforward. The following commands are meant to make this easier.

To add a dependency to a package, run:

scope=[package_name] npm run add [dependency]

And to remove one:

scope=[package_name] npm run remove [dependency]

For example, here is how you would add typescript to the @padloc/server package:

scope=server npm run add typescript

Note: We're trying to keep the number and size of third-party dependencies to a minumum, so before you add a dependency, please think twice if it is really needed! Pull requests with unnecessary dependencies will very likely be rejected.

Updating The Version

The Padloc project consists of many different subpackages. To simplify versioning, we use a global version for all them. This means that when releasing a new version, the version of all subpackages needs to be updated, regardless of whether there have been changes in them or not. To update the global version accross the project, you can use the following command:

npm run version [semver_version]

Deployment / Publishing

Padloc has a lot of different components that all need to be built/released/published in different ways. To manage this complexitiy, we have compiled all deployment steps for all components in a single Github Workflow. To release a new version, simply:

  1. Update project version
  2. Commit and push.
  3. Run the Publish Release action.

Licensing

This software is published under the GNU Affero General Public License. If you wish to acquire a commercial license, please contact us as sales@padloc.app.