A fork of Padloc that:
- Suits my personal wants/needs
- Uses pnpm workspaces instead of Lerna + npm
- Builds the server with esbuild instead of live-building with ts-node
Simple, secure password and data management for individuals and teams.
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 |
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 [email protected]:padloc/padloc.git
cd padloc
pnpm i --frozen-lockfile
pnpm 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!
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.
For a security design overview, check out the security whitepaper.
Setting up your dev environment for working with Padloc is as simple as:
git clone [email protected]:padloc/padloc.git
cd padloc
pnpm i --frozen-lockfile
This may take a minute, so maybe grab a cup of โ๏ธ.
To start "dev mode", simply run
pnpm 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.
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.
pnpm run format
To simply check whether everything is formatted correctly, you can use the following command:
pnpm run format:check
To run unit tests, use:
pnpm run test
Cypress end-to-end tests can be run via:
pnpm run test:e2e
And to start cypress tests in "dev mode":
pnpm run test:e2e:dev
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:
pnpm --filter @padloc/[package_name] add [dependency]
And to remove one:
pnpm --filter @padloc/[package_name] remove [dependency]
For example, here is how you would add typescript
to the @padloc/server
package:
pnpm --filter @padloc/server 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.
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:
# Note: This command has not been tested, as Lerna is no longer used here
pnpm dlx lerna version [semver_version]
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:
- Update project version
- Commit and push.
- Run the Publish Release action.
This software is published under the GNU Affero General Public License. If you wish to acquire a commercial license, please contact us as [email protected].